home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / complib / sgimath.z / sgimath
Encoding:
Text File  |  1998-10-30  |  278.0 KB  |  6,733 lines

  1.  
  2.  
  3.  
  4. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      complib, complib.sgimath, sgimath - Scientific and Mathematical Library
  10.  
  11.  
  12. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  13.      The Silicon Graphics Scientific Mathematical Library, complib.sgimath, is
  14.      a comprehensive collection of high-performance math libraries providing
  15.      technical support for mathematical and numerical techniques used in
  16.      scientific and technical computing.  This library is provided by SGI for
  17.      the convenience of the users.  Support is limited to bug fixes at SGI's
  18.      discretion.
  19.  
  20.  
  21.      The library complib.sgimath contains an extensive collection of industry
  22.      standard libraries such as Basic Linear Algebra Subprograms (BLAS), the
  23.      Extended BLAS (Level 2 and Level 3), EISPACK, LINPACK, and LAPACK.
  24.      Internally developed libraries for calculating Fast Fourier Transforms
  25.      (FFT's) and Convolutions are also included, as well as select direct
  26.      sparse matrix solvers. Documentation is available per routine via
  27.      individual man pages. General man pages for the Blas ( mmmmaaaannnn bbbbllllaaaassss ), fft
  28.      routines ( mmmmaaaannnn fffffffftttt ), convolution routines ( mmmmaaaannnn ccccoooonnnnvvvv ) and LAPACK ( mmmmaaaannnn
  29.      llllaaaappppaaaacccckkkk ) are also available.
  30.  
  31.  
  32.      The complib.sgimath library is available on Silicon Graphics Inc.
  33.      machines via the -l compilation flag, -lcomplib.sgimath (append _mp for
  34.      multiprocessing libraries) for OS versions 5.1 and higher.  The library
  35.      is available for R3000, R4000 (-mips2) and R8000 architectures (-mips4),
  36.      and single and multiple processor architectures (-mp).
  37.  
  38.      Documentation for LAPACK and LINPACK is available by writing:
  39.  
  40.         SIAM Department BKLP93
  41.         P.O. Box 7260
  42.         Philadelphia, Pennsylvania 19101
  43.  
  44.         Anderson E., et. al. SIAM 1992 "LAPACK Users Guide", $19.50
  45.         Dongarra J., et. al. SIAM 1979 "LINPACK Users Guide", $19.50
  46.  
  47.  
  48. AAAAVVVVAAAAIIIILLLLAAAABBBBIIIILLLLIIIITTTTYYYY
  49.      Many of the routines in complib.sgimath are available from:
  50.      netlib@research.att.com.
  51.  
  52.              mail netlib@research.att.com
  53.              send index
  54.  
  55.      The Internet address "netlib@research.att.com" refers to a gateway
  56.      machine, 192.20.225.2, at AT&T Bell Labs in Murray Hill, New Jersey.
  57.      This address should be understood on all the major networks.  For systems
  58.      having only uucp connections, use uunet!research!netlib.  In this case,
  59.      someone will be paying for long distance 1200bps phone calls, so keep
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  71.  
  72.  
  73.  
  74.      your requests to a reasonable size!
  75.  
  76.      If ftp is more convenient for you than email, you may connect to
  77.      "research.att.com"; log in as "netlib".  (This is for read-only ftp, not
  78.      telnet.)  Filesnames end in ".Z", reflecting the need to have the
  79.      "uncompress" command applied after you've ftp'd them.  "compress" source
  80.      code for a variety of machines and operating systems can be obtained by
  81.      anonymous ftp from ftp.uu.net.  The files in netlib/crc/res/ have a list
  82.      of files with modification times, lengths, and checksums to assist people
  83.      who wish to automatically track changes.
  84.  
  85.      For access from Europe, try the duplicate collection in Oslo:
  86.              Internet:       netlib@nac.no
  87.              EARN/BITNET:    netlib%nac.no@norunix.bitnet  (now livid.uib.no
  88.      ?)
  89.              X.400:          s=netlib; o=nac; prmd=uninett; c=no;
  90.              EUNET/uucp:     nuug!netlib
  91.      For the Pacific, try    netlib@draci.cs.uow.edu.au located at the
  92.      University of Wollongong, NSW, Australia.
  93.  
  94.      The contents of netlib (other than toms) is available on CD-ROM from
  95.      Prime Time Freeware.  The price of their two-disc set, which also
  96.      includes statlib, TeX, Modula3, Interview, Postgres, Tcl/Tk, and more is
  97.      about $60; for current information contact
  98.  
  99.      Prime Time Freeware 370 Altair Way, Suite 150     Tel: +1 408-738-4832
  100.      ptf@cfcl.com        Sunnyvale, CA  94086  USA     Fax: +1 408-738-2050
  101.  
  102.      The following libraries are available from "netlib@research.att.com".
  103.      These libraries are part of complib.sgimath.
  104.  
  105.      The BLAS library, level 1, 2 and 3 and machine constants.
  106.  
  107.      The LAPACK library, for the most common problems in numerical linear
  108.      algebra:  linear equations, linear least squares problems, eigenvalue
  109.      problems, and singular value problems. It has been designed to be
  110.      efficient on a wide range of modern high-performance computers.
  111.  
  112.      The LINPACK library, for linear  equations and linear least squares
  113.      problems, linear systems whose matrices are general, banded, symmetric
  114.      indefinite, symmetric positive definite, triangular, and tridiagonal
  115.      square.  In addition, the package computes the QR and singular value
  116.      decompositions of rectangular matrices and applies them to least squares
  117.      problems.
  118.  
  119.      The EISPACK library, a collection of double precision Fortran subroutines
  120.      that compute the eigenvalues and eigenvectors of nine classes of
  121.      matrices.  The package can determine the eigensystems of double complex
  122.      general, double complex Hermitian, double precision general, double
  123.      precision symmetric, double precision symmetric band, double precision
  124.      symmetric tridiagonal, special double precision tridiagonal, generalized
  125.      double precision, and generalized double precision symmetric matrices. In
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  137.  
  138.  
  139.  
  140.      addition, there are two routines which use the singular value
  141.      decomposition to solve certain least squares problems.
  142.  
  143.  
  144. IIIINNNNDDDDEEEEXXXX
  145.      BBBBLLLLAAAASSSS LLLLIIIIBBBBRRRRAAAARRRRYYYY ---- BBBBaaaassssiiiicccc LLLLiiiinnnneeeeaaaarrrr AAAAllllggggeeeebbbbrrrraaaa SSSSuuuubbbbpppprrrrooooggggrrrraaaammmmssss
  146.  
  147.      BBBBLLLLAAAASSSS LLLLeeeevvvveeeellll 1111
  148.      dnrm2, snrm2, zdnrm2, csnrm2      -  BLAS level ONE Euclidean norm
  149.      functions.
  150.      dcopy, scopy, zcopy, ccopy        -  BLAS level ONE copy subroutines
  151.      drotg, srotg, drot, srot          -  BLAS level ONE rotation subroutines
  152.      idamax, isamax, izamax, icamax    -  BLAS level ONE Maximum index
  153.      functions
  154.      ddot, sdot, zdotc, cdotc, zdotu, cdotu -  BLAS level ONE, dot product
  155.      functions
  156.      dswap, sswap, zswap, cswap        -  BLAS level ONE swap subroutines
  157.      dasum, sasum, dzasum, scasum      -  BLAS level ONE L1 norm functions.
  158.      dscal, sscal, zscal, cscal, zdscal, csscal -  BLAS level ONE scaling
  159.      subroutines
  160.      daxpy, saxpy, zaxpy, caxpy        -  BLAS level ONE axpy subroutines
  161.  
  162.      BBBBLLLLAAAASSSS LLLLeeeevvvveeeellll 2222 dgemv, sgemv, zgemv, cgemv  -  BLAS Level Two Matrix-Vector
  163.      Product
  164.      dspr, sspr, zhpr, chpr -  BLAS Level Two   Symmetric Packed Matrix Rank 1
  165.      Update
  166.      dsyr, ssyr, zher, cher -  BLAS Level Two   (Symmetric/Hermitian)Matrix
  167.      Rank 1 Update
  168.      dtpmv, stpmv, ztpmv, ctpmv -  BLAS Level Two Matrix-Vector Product
  169.      dtpsv, stpsv, ztpsv, ctpsv -  BLAS Level Two Solution of Triangular
  170.      System
  171.      dger, sger, zgeru, cgeru, zgerc, cgerc -  BLAS Level Two   Rank 1
  172.      Operation
  173.      dspr2, sspr2, zhpr2, chpr2 -  BLAS Level Two   Symmetric Packed Matrix
  174.      Rank 2 Update
  175.      dsyr2, ssyr2, zher2, cher2 -  BLAS Level Two
  176.      (Symmetric/Hermitian)Matrix Rank 2 Update
  177.      dsbmv, ssbmv, zhbmv, chbmv -  BLAS Level Two   (Symmetric/Hermitian)
  178.      Banded Matrix - Vector Product
  179.      dtrmv, strmv, ztrmv, ctrmv -  BLAS Level Two Matrix-Vector Product
  180.      dtrsv, strsv, ztrsv, ctrsv -  BLAS Level Two Solution of triangular
  181.      system of equations.
  182.      dgbmv, sgbmv, zgbmv, cgbmv -  BLAS Level Two Matrix-Vector Product
  183.      dspmv, sspmv, zhpmv, chpmv -  BLAS Level Two   (Symmetric/Hermitian)
  184.      Packed Matrix - Vector Product
  185.      dsymv, ssymv, zhemv, chemv -  BLAS Level Two
  186.      (Symmetric/Hermitian)Matrix - Vector Product
  187.      dtbmv, stbmv, ztbmv, ctbmv, dtbsv, stbsv, ztbsv, ctbsv -  BLAS Level Two
  188.      Matrix-Vector Product  and  Solution of System of Equations.
  189.  
  190.      BBBBLLLLAAAASSSS LLLLeeeevvvveeeellll 3333 dtrmm, strmm, ztrmm, ctrmm -  BLAS level three Matrix
  191.      Product
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  203.  
  204.  
  205.  
  206.      zhemm, chemm -  BLAS level three   Hermitian Matrix Product
  207.      dsyr2k, ssyr2k, zsyr2k, csyr2k -  BLAS level three  Symetric Rank 2K
  208.      Update.
  209.      zher2k and cher2k -  BLAS level three   Hermitian Rank 2K Update
  210.      dsymm, ssymm, zsymm, csymm -  BLAS level three   Symmetric Matrix Product
  211.      dsyrk, ssyrk, zsyrk, csyrk -  BLAS level three  Symetric Rank K Update.
  212.      dtrsm, strsm, ztrsm, ctrsm -  BLAS level three   Solution of Systems of
  213.      Equations
  214.      dgemm, sgemm, zgemm, cgemm -  BLAS level three Matrix Product
  215.      zherk and cherk -  BLAS level three   Hermitiam Rank K Update
  216.  
  217.  
  218.      EEEEIIIISSSSPPPPAAAACCCCKKKK LLLLIIIIBBBBRRRRAAAARRRRYYYY
  219.  
  220.  
  221.      BAKVEC  - This subroutine forms the eigenvectors of a NONSYMMETRIC
  222.      TRIDIAGONAL matrix by back transforming those of the corresponding
  223.      symmetric matrix determined by  FIGI.
  224.  
  225.  
  226.      BALANC  - This subroutine balances a REAL matrix and isolates eigenvalues
  227.      whenever possible.
  228.  
  229.  
  230.      BALBAK  - This subroutine forms the eigenvectors of a REAL GENERAL matrix
  231.      by back transforming those of the corresponding balanced matrix
  232.      determined by  BALANC.
  233.  
  234.  
  235.      BANDR   - This subroutine reduces a REAL SYMMETRIC BAND matrix to a
  236.      symmetric tridiagonal matrix using and optionally accumulating orthogonal
  237.      similarity transformations.
  238.  
  239.  
  240.      BANDV   - This subroutine finds those eigenvectors of a REAL SYMMETRIC
  241.      BAND matrix corresponding to specified eigenvalues, using inverse
  242.      iteration.  The subroutine may also be used to solve systems of linear
  243.      equations with a symmetric or non-symmetric band coefficient matrix.
  244.  
  245.  
  246.      BISECT  - This subroutine finds those eigenvalues of a TRIDIAGONAL
  247.      SYMMETRIC matrix which lie in a specified interval, using bisection.
  248.  
  249.  
  250.      BQR     - This subroutine finds the eigenvalue of smallest (usually)
  251.      magnitude of a REAL SYMMETRIC BAND matrix using the QR algorithm with
  252.      shifts of origin.  Consecutive calls can be made to find further
  253.      eigenvalues.
  254.  
  255.  
  256.      CBABK2  - This subroutine forms the eigenvectors of a COMPLEX GENERAL
  257.      matrix by back transforming those of the corresponding balanced matrix
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  269.  
  270.  
  271.  
  272.      determined by  CBAL.
  273.  
  274.  
  275.      CBAL    - This subroutine balances a COMPLEX matrix and isolates
  276.      eigenvalues whenever possible.
  277.  
  278.  
  279.      CDIV    - COMPLEX DIVISION, (CR,CI) = (AR,AI)/(BR,BI)
  280.  
  281.  
  282.      CG      - This subroutine calls the recommended sequence of subroutines
  283.      from the eigensystem subroutine package (EISPACK) to find the eigenvalues
  284.      and eigenvectors (if desired) of a COMPLEX GENERAL matrix.
  285.  
  286.  
  287.      CH      - This subroutine calls the recommended sequence of subroutines
  288.      from the eigensystem subroutine package (EISPACK) to find the eigenvalues
  289.      and eigenvectors (if desired) of a COMPLEX HERMITIAN matrix.
  290.  
  291.  
  292.      CINVIT  - This subroutine finds those eigenvectors of A COMPLEX UPPER
  293.      Hessenberg matrix corresponding to specified eigenvalues, using inverse
  294.      iteration.
  295.  
  296.  
  297.      COMBAK  - This subroutine forms the eigenvectors of a COMPLEX GENERAL
  298.      matrix by back transforming those of the corresponding upper Hessenberg
  299.      matrix determined by  COMHES.
  300.  
  301.  
  302.      COMHES  - Given a COMPLEX GENERAL matrix, this subroutine reduces a
  303.      submatrix situated in rows and columns LOW through IGH to upper
  304.      Hessenberg form by stabilized elementary similarity transformations.
  305.  
  306.  
  307.      COMLR   - This subroutine finds the eigenvalues of a COMPLEX UPPER
  308.      Hessenberg matrix by the modified LR method.
  309.  
  310.  
  311.      COMLR2  - This subroutine finds the eigenvalues and eigenvectors of a
  312.      COMPLEX UPPER Hessenberg matrix by the modified LR method.  The
  313.      eigenvectors of a COMPLEX GENERAL matrix can also be found if  COMHES
  314.      has been used to reduce this general matrix to Hessenberg form.
  315.  
  316.  
  317.      COMQR   - This subroutine finds the eigenvalues of a COMPLEX upper
  318.      Hessenberg matrix by the QR method.
  319.  
  320.  
  321.      COMQR2  - This subroutine finds the eigenvalues and eigenvectors of a
  322.      COMPLEX UPPER Hessenberg matrix by the QR method.  The eigenvectors of a
  323.      COMPLEX GENERAL matrix can also be found if  CORTH  has been used to
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  335.  
  336.  
  337.  
  338.      reduce this general matrix to Hessenberg form.
  339.  
  340.  
  341.      CORTB   - This subroutine forms the eigenvectors of a COMPLEX GENERAL
  342.      matrix by back transforming those of the corresponding upper Hessenberg
  343.      matrix determined by  CORTH.
  344.  
  345.  
  346.      CORTH   - Given a COMPLEX GENERAL matrix, this subroutine reduces a
  347.      submatrix situated in rows and columns LOW through IGH to upper
  348.      Hessenberg form by unitary similarity transformations.
  349.  
  350.  
  351.      CSROOT  - (YR,YI) = COMPLEX SQRT(XR,XI) BRANCH CHOSEN SO THAT YR .GE. 0.0
  352.      AND SIGN(YI) .EQ. SIGN(XI)
  353.  
  354.  
  355.      ELMBAK  - This subroutine forms the eigenvectors of a REAL GENERAL matrix
  356.      by back transforming those of the corresponding upper Hessenberg matrix
  357.      determined by  ELMHES.
  358.  
  359.  
  360.      ELMHES  - Given a REAL GENERAL matrix, this subroutine reduces a
  361.      submatrix situated in rows and columns LOW through IGH to upper
  362.      Hessenberg form by stabilized elementary similarity transformations.
  363.  
  364.  
  365.      ELTRAN  - This subroutine accumulates the stabilized elementary
  366.      similarity transformations used in the reduction of a REAL GENERAL matrix
  367.      to upper Hessenberg form by  ELMHES.
  368.  
  369.  
  370.      EPSLON  - ESTIMATE UNIT ROUNDOFF IN QUANTITIES OF SIZE X.
  371.  
  372.  
  373.      FIGI    - Given a NONSYMMETRIC TRIDIAGONAL matrix such that the products
  374.      of corresponding pairs of off-diagonal elements are all non-negative,
  375.      this subroutine reduces it to a symmetric tridiagonal matrix with the
  376.      same eigenvalues.  If, further, a zero product only occurs when both
  377.      factors are zero, the reduced matrix is similar to the original matrix.
  378.  
  379.  
  380.      FIGI2   - Given a NONSYMMETRIC TRIDIAGONAL matrix such that the products
  381.      of corresponding pairs of off-diagonal elements are all non-negative, and
  382.      zero only when both factors are zero, this subroutine reduces it to a
  383.      SYMMETRIC TRIDIAGONAL matrix using and accumulating diagonal similarity
  384.      transformations.
  385.  
  386.  
  387.      HQR     - This subroutine finds the eigenvalues of a REAL UPPER
  388.      Hessenberg matrix by the QR method.
  389.  
  390.  
  391.  
  392.  
  393.                                                                         PPPPaaaaggggeeee 6666
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  401.  
  402.  
  403.  
  404.      HQR2    - This subroutine finds the eigenvalues and eigenvectors of a
  405.      REAL UPPER Hessenberg matrix by the QR method.  The eigenvectors of a
  406.      REAL GENERAL matrix can also be found if  ELMHES  and  ELTRAN  or  ORTHES
  407.      and  ORTRAN  have been used to reduce this general matrix to Hessenberg
  408.      form and to accumulate the similarity transformations.
  409.  
  410.  
  411.      HTRIB3  - This subroutine forms the eigenvectors of a COMPLEX HERMITIAN
  412.      matrix by back transforming those of the corresponding real symmetric
  413.      tridiagonal matrix determined by  HTRID3.
  414.  
  415.  
  416.      HTRIBK  - This subroutine forms the eigenvectors of a COMPLEX HERMITIAN
  417.      matrix by back transforming those of the corresponding real symmetric
  418.      tridiagonal matrix determined by  HTRIDI.
  419.  
  420.  
  421.      HTRID3  - This subroutine reduces a COMPLEX HERMITIAN matrix, stored as a
  422.      single square array, to a real symmetric tridiagonal matrix using unitary
  423.      similarity transformations.
  424.  
  425.  
  426.      HTRIDI  - This subroutine reduces a COMPLEX HERMITIAN matrix to a real
  427.      symmetric tridiagonal matrix using unitary similarity transformations.
  428.  
  429.  
  430.      IMTQL1  - This subroutine finds the eigenvalues of a SYMMETRIC
  431.      TRIDIAGONAL matrix by the implicit QL method.
  432.  
  433.  
  434.      IMTQL2  - This subroutine finds the eigenvalues and eigenvectors of a
  435.      SYMMETRIC TRIDIAGONAL matrix by the implicit QL method.  The eigenvectors
  436.      of a FULL SYMMETRIC matrix can also be found if  TRED2  has been used to
  437.      reduce this full matrix to tridiagonal form.
  438.  
  439.  
  440.      IMTQLV  - This subroutine finds the eigenvalues of a SYMMETRIC
  441.      TRIDIAGONAL matrix by the implicit QL method and associates with them
  442.      their corresponding submatrix indices.
  443.  
  444.  
  445.      INVIT   - This subroutine finds those eigenvectors of a REAL UPPER
  446.      Hessenberg matrix corresponding to specified eigenvalues, using inverse
  447.      iteration.
  448.  
  449.  
  450.      MINFIT  - This subroutine determines, towards the solution of the linear
  451.         T system AX=B, the singular value decomposition A=USV  of a real
  452.         T M by N rectangular matrix, forming U B rather than U.  Householder
  453.      bidiagonalization and a variant of the QR algorithm are used.
  454.  
  455.  
  456.  
  457.  
  458.  
  459.                                                                         PPPPaaaaggggeeee 7777
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  467.  
  468.  
  469.  
  470.      ORTBAK  - This subroutine forms the eigenvectors of a REAL GENERAL matrix
  471.      by back transforming those of the corresponding upper Hessenberg matrix
  472.      determined by  ORTHES.
  473.  
  474.  
  475.      ORTHES  - Given a REAL GENERAL matrix, this subroutine reduces a
  476.      submatrix situated in rows and columns LOW through IGH to upper
  477.      Hessenberg form by orthogonal similarity transformations.
  478.  
  479.  
  480.      ORTRAN  - This subroutine accumulates the orthogonal similarity
  481.      transformations used in the reduction of a REAL GENERAL matrix to upper
  482.      Hessenberg form by  ORTHES.
  483.  
  484.  
  485.      PYTHAG  - FINDS SQRT(A**2+B**2) WITHOUT OVERFLOW OR DESTRUCTIVE UNDERFLOW
  486.  
  487.  
  488.      QZHES   - This subroutine accepts a pair of REAL GENERAL matrices and
  489.      reduces one of them to upper Hessenberg form and the other to upper
  490.      triangular form using orthogonal transformations.  It is usually followed
  491.      by  QZIT,  QZVAL  and, possibly,  QZVEC.
  492.  
  493.  
  494.      QZIT    - This subroutine accepts a pair of REAL matrices, one of them in
  495.      upper Hessenberg form and the other in upper triangular form.  It reduces
  496.      the Hessenberg matrix to quasi-triangular form using orthogonal
  497.      transformations while maintaining the triangular form of the other
  498.      matrix.  It is usually preceded by  QZHES  and followed by  QZVAL  and,
  499.      possibly,  QZVEC.
  500.  
  501.  
  502.      QZVAL   - This subroutine accepts a pair of REAL matrices, one of them in
  503.      quasi-triangular form and the other in upper triangular form.  It reduces
  504.      the quasi-triangular matrix further, so that any remaining 2-by-2 blocks
  505.      correspond to pairs of complex eigenvalues, and returns quantities whose
  506.      ratios give the generalized eigenvalues.  It is usually preceded by
  507.      QZHES and  QZIT  and may be followed by  QZVEC.
  508.  
  509.  
  510.      QZVEC   - This subroutine accepts a pair of REAL matrices, one of them in
  511.      quasi-triangular form (in which each 2-by-2 block corresponds to a pair
  512.      of complex eigenvalues) and the other in upper triangular form.  It
  513.      computes the eigenvectors of the triangular problem and transforms the
  514.      results back to the original coordinate system.  It is usually preceded
  515.      by  QZHES,  QZIT, and  QZVAL.
  516.  
  517.  
  518.      RATQR   - This subroutine finds the algebraically smallest or largest
  519.      eigenvalues of a SYMMETRIC TRIDIAGONAL matrix by the rational QR method
  520.      with Newton corrections.
  521.  
  522.  
  523.  
  524.  
  525.                                                                         PPPPaaaaggggeeee 8888
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  533.  
  534.  
  535.  
  536.      REBAK   - This subroutine forms the eigenvectors of a generalized
  537.      SYMMETRIC eigensystem by back transforming those of the derived symmetric
  538.      matrix determined by  REDUC.
  539.  
  540.  
  541.      REBAKB  - This subroutine forms the eigenvectors of a generalized
  542.      SYMMETRIC eigensystem by back transforming those of the derived symmetric
  543.      matrix determined by  REDUC2.
  544.  
  545.  
  546.      REDUC   - This subroutine reduces the generalized SYMMETRIC eigenproblem
  547.      Ax=(LAMBDA)Bx, where B is POSITIVE DEFINITE, to the standard symmetric
  548.      eigenproblem using the Cholesky factorization of B.
  549.  
  550.  
  551.      REDUC2  - This subroutine reduces the generalized SYMMETRIC eigenproblems
  552.      ABx=(LAMBDA)x OR BAy=(LAMBDA)y, where B is POSITIVE DEFINITE, to the
  553.      standard symmetric eigenproblem using the Cholesky factorization of B.
  554.  
  555.  
  556.      RG      - This subroutine calls the recommended sequence of subroutines
  557.      from the eigensystem subroutine package (EISPACK) To find the eigenvalues
  558.      and eigenvectors (if desired) of a REAL GENERAL matrix.
  559.  
  560.  
  561.      RGG     - This subroutine calls the recommended sequence of subroutines
  562.      from the eigensystem subroutine package (EISPACK) to find the eigenvalues
  563.      and eigenvectors (if desired) for the REAL GENERAL GENERALIZED
  564.      eigenproblem  Ax = (LAMBDA)Bx.
  565.  
  566.  
  567.      RS      - This subroutine calls the recommended sequence of subroutines
  568.      from the eigensystem subroutine package (EISPACK) to find the eigenvalues
  569.      and eigenvectors (if desired) of a REAL SYMMETRIC matrix.
  570.  
  571.  
  572.      RSB     - This subroutine calls the recommended sequence of subroutines
  573.      from the eigensystem subroutine package (EISPACK) to find the eigenvalues
  574.      and eigenvectors (if desired) of a REAL SYMMETRIC BAND matrix.
  575.  
  576.  
  577.      RSG     - This subroutine calls the recommended sequence of subroutines
  578.      from the eigensystem subroutine package (EISPACK) To find the eigenvalues
  579.      and eigenvectors (if desired) for the REAL SYMMETRIC generalized
  580.      eigenproblem  Ax = (LAMBDA)Bx.
  581.  
  582.  
  583.      RSGAB   - This subroutine calls the recommended sequence of subroutines
  584.      from the eigensystem subroutine package (EISPACK) to find the eigenvalues
  585.      and eigenvectors (if desired) for the REAL SYMMETRIC generalized
  586.      eigenproblem  ABx = (LAMBDA)x.
  587.  
  588.  
  589.  
  590.  
  591.                                                                         PPPPaaaaggggeeee 9999
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  599.  
  600.  
  601.  
  602.      RSGBA   - This subroutine calls the recommended sequence of subroutines
  603.      from the eigensystem subroutine package (EISPACK) to find the eigenvalues
  604.      and eigenvectors (if desired) for the REAL SYMMETRIC generalized
  605.      eigenproblem  BAx = (LAMBDA)x.
  606.  
  607.  
  608.      RSM     - THIS SUBROUTINE CALLS THE RECOMMENDED SEQUENCE OF SUBROUTINES
  609.      FROM THE EIGENSYSTEM SUBROUTINE PACKAGE (EISPACK) TO FIND ALL OF THE
  610.      EIGENVALUES AND SOME OF THE EIGENVECTORS OF A REAL SYMMETRIC MATRIX.
  611.  
  612.  
  613.      RSP     - This subroutine calls the recommended sequence of subroutines
  614.      from the eigensystem subroutine package (EISPACK) to find the eigenvalues
  615.      and eigenvectors (if desired) of a REAL SYMMETRIC PACKED matrix.
  616.  
  617.  
  618.      RST     - This subroutine calls the recommended sequence of subroutines
  619.      from the eigensystem subroutine package (EISPACK) to find the eigenvalues
  620.      and eigenvectors (if desired) of a REAL SYMMETRIC TRIDIAGONAL matrix.
  621.  
  622.  
  623.      RT      - This subroutine calls the recommended sequence of subroutines
  624.      from the eigensystem subroutine package (EISPACK) to find the eigenvalues
  625.      and eigenvectors (if desired) of a special REAL TRIDIAGONAL matrix.
  626.  
  627.  
  628.      SVD     - This subroutine determines the singular value decomposition
  629.         T A=USV  of a REAL M by N rectangular matrix.  Householder
  630.      bidiagonalization and a variant of the QR algorithm are used.
  631.  
  632.  
  633.      TINVIT  - This subroutine finds those eigenvectors of a TRIDIAGONAL
  634.      SYMMETRIC matrix corresponding to specified eigenvalues, using inverse
  635.      iteration.
  636.  
  637.  
  638.      TQL1    - This subroutine finds the eigenvalues of a SYMMETRIC
  639.      TRIDIAGONAL matrix by the QL method.
  640.  
  641.  
  642.      TQL2    - This subroutine finds the eigenvalues and eigenvectors of a
  643.      SYMMETRIC TRIDIAGONAL matrix by the QL method.  The eigenvectors of a
  644.      FULL SYMMETRIC matrix can also be found if  TRED2  has been used to
  645.      reduce this full matrix to tridiagonal form.
  646.  
  647.  
  648.      TQLRAT  - This subroutine finds the eigenvalues of a SYMMETRIC
  649.      TRIDIAGONAL matrix by the rational QL method.
  650.  
  651.  
  652.      TRBAK1  - This subroutine forms the eigenvectors of a REAL SYMMETRIC
  653.      matrix by back transforming those of the corresponding symmetric
  654.  
  655.  
  656.  
  657.                                                                        PPPPaaaaggggeeee 11110000
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  665.  
  666.  
  667.  
  668.      tridiagonal matrix determined by  TRED1.
  669.  
  670.  
  671.      TRBAK3  - This subroutine forms the eigenvectors of a REAL SYMMETRIC
  672.      matrix by back transforming those of the corresponding symmetric
  673.      tridiagonal matrix determined by  TRED3.
  674.  
  675.  
  676.      TRED1   - This subroutine reduces a REAL SYMMETRIC matrix to a symmetric
  677.      tridiagonal matrix using orthogonal similarity transformations.
  678.  
  679.  
  680.      TRED2   - This subroutine reduces a REAL SYMMETRIC matrix to a symmetric
  681.      tridiagonal matrix using and accumulating orthogonal similarity
  682.      transformations.
  683.  
  684.  
  685.      TRED3   - This subroutine reduces a REAL SYMMETRIC matrix, stored as a
  686.      one-dimensional array, to a symmetric tridiagonal matrix using orthogonal
  687.      similarity transformations.
  688.  
  689.  
  690.      TRIDIB  - This subroutine finds those eigenvalues of a TRIDIAGONAL
  691.      SYMMETRIC matrix between specified boundary indices, using bisection.
  692.  
  693.  
  694.      TSTURM  - This subroutine finds those eigenvalues of a TRIDIAGONAL
  695.      SYMMETRIC matrix which lie in a specified interval and their associated
  696.      eigenvectors, using bisection and inverse iteration.
  697.  
  698.  
  699.      LLLLIIIINNNNPPPPAAAACCCCKKKK LLLLIIIIBBBBRRRRAAAARRRRYYYY
  700.  
  701.  
  702.      CCHDC   - CCHDC computes the Cholesky decomposition of a positive
  703.      definite matrix.  A pivoting option allows the user to estimate the
  704.      condition of a positive definite matrix or determine the rank of a
  705.      positive semidefinite matrix.
  706.  
  707.      CCHDD   - CCHDD downdates an augmented Cholesky decomposition or the
  708.      triangular factor of an augmented QR decomposition.  Specifically, given
  709.      an upper triangular matrix R of order P,  a row vector X, a column vector
  710.      Z, and a scalar Y, CCHDD determines a unitary matrix U and a scalar ZETA
  711.      such that
  712.  
  713.         (R   Z )     (RR  ZZ)
  714.         U * (      )  =  (      ) ,
  715.         (0 ZETA)     ( X   Y)
  716.  
  717.      where RR is upper triangular.  If R and Z have been obtained from the
  718.      factorization of a least squares problem, then RR and ZZ are the factors
  719.      corresponding to the problem with the observation (X,Y) removed.  In this
  720.  
  721.  
  722.  
  723.                                                                        PPPPaaaaggggeeee 11111111
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  731.  
  732.  
  733.  
  734.      case, if RHO is the norm of the residual vector, then the norm of the
  735.      residual vector of the downdated problem is SQRT(RHO**2 - ZETA**2).
  736.      CCHDD will simultaneously downdate several triplets (Z,Y,RHO) along with
  737.      R.  For a less terse description of what CCHDD does and how it may be
  738.      applied, see the LINPACK Guide.
  739.  
  740.      CCHEX   - CCHEX updates the Cholesky factorization
  741.  
  742.         A = CTRANS(R)*R
  743.  
  744.      of a positive definite matrix A of order P under diagonal permutations of
  745.      the form
  746.  
  747.         TRANS(E)*A*E
  748.  
  749.      where E is a permutation matrix.  Specifically, given an upper triangular
  750.      matrix R and a permutation matrix E (which is specified by K, L, and
  751.      JOB), CCHEX determines a unitary matrix U such that
  752.  
  753.         U*R*E = RR,
  754.  
  755.      where RR is upper triangular.  At the users option, the transformation U
  756.      will be multiplied into the array Z.  If A = CTRANS(X)*X, so that R is
  757.      the triangular part of the QR factorization of X, then RR is the
  758.      triangular part of the QR factorization of X*E, i.e. X with its columns
  759.      permuted.  For a less terse description of what CCHEX does and how it may
  760.      be applied, see the LINPACK Guide.
  761.  
  762.      CCHUD   - CCHUD updates an augmented Cholesky decomposition of the
  763.      triangular part of an augmented QR decomposition.  Specifically, given an
  764.      upper triangular matrix R of order P, a row vector X, a column vector Z,
  765.      and a scalar Y, CCHUD determines a unitary matrix U and a scalar ZETA
  766.      such that
  767.  
  768.  
  769.         (R  Z)     (RR   ZZ )
  770.         U  * (    )  =  (        ) ,
  771.         (X  Y)     ( 0  ZETA)
  772.  
  773.      where RR is upper triangular.  If R and Z have been obtained from the
  774.      factorization of a least squares problem, then RR and ZZ are the factors
  775.      corresponding to the problem with the observation (X,Y) appended.  In
  776.      this case, if RHO is the norm of the residual vector, then the norm of
  777.      the residual vector of the updated problem is SQRT(RHO**2 + ZETA**2).
  778.      CCHUD will simultaneously update several triplets (Z,Y,RHO).
  779.  
  780.      CGBCO   - CGBCO factors a complex band matrix by Gaussian elimination and
  781.      estimates the condition of the matrix.
  782.  
  783.      CGBDI   - CGBDI computes the determinant of a band matrix using the
  784.      factors computed by CGBCO or CGBFA.  If the inverse is needed, use CGBSL
  785.      N  times.
  786.  
  787.  
  788.  
  789.                                                                        PPPPaaaaggggeeee 11112222
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  797.  
  798.  
  799.  
  800.      CGBFA   - CGBFA factors a complex band matrix by elimination.
  801.  
  802.      CGBSL   - CGBSL solves the complex band system A * X = B  or  CTRANS(A) *
  803.      X = B using the factors computed by CGBCO or CGBFA.
  804.  
  805.      CGECO   - CGECO factors a complex matrix by Gaussian elimination and
  806.      estimates the condition of the matrix.
  807.  
  808.      CGEDI   - CGEDI computes the determinant and inverse of a matrix using
  809.      the factors computed by CGECO or CGEFA.
  810.  
  811.      CGEFA   - CGEFA factors a complex matrix by Gaussian elimination.
  812.  
  813.      CGESL   - CGESL solves the complex system A * X = B  or  CTRANS(A) * X =
  814.      B using the factors computed by CGECO or CGEFA.
  815.  
  816.      CGTSL   - CGTSL given a general tridiagonal matrix and a right hand side
  817.      will find the solution.
  818.  
  819.      CHICO   - CHICO factors a complex Hermitian matrix by elimination with
  820.      symmetric pivoting and estimates the condition of the matrix.
  821.  
  822.      CHIDI   - CHIDI computes the determinant, inertia and inverse of a
  823.      complex Hermitian matrix using the factors from CHIFA.
  824.  
  825.      CHIFA   - CHIFA factors a complex Hermitian matrix by elimination with
  826.      symmetric pivoting.
  827.  
  828.      CHISL   - CHISL solves the complex Hermitian system A * X = B using the
  829.      factors computed by CHIFA.
  830.  
  831.      CHPCO   - CHPCO factors a complex Hermitian matrix stored in packed form
  832.      by elimination with symmetric pivoting and estimates the condition of the
  833.      matrix.
  834.  
  835.      CHPDI   - CHPDI computes the determinant, inertia and inverse of a
  836.      complex Hermitian matrix using the factors from CHPFA, where the matrix
  837.      is stored in packed form.
  838.  
  839.      CHPFA   - CHPFA factors a complex Hermitian matrix stored in packed form
  840.      by elimination with symmetric pivoting.
  841.  
  842.      CHPSL   - CHISL solves the complex Hermitian system A * X = B using the
  843.      factors computed by CHPFA.
  844.  
  845.      CPBCO   - CPBCO factors a complex Hermitian positive definite matrix
  846.      stored in band form and estimates the condition of the matrix.
  847.  
  848.      CPBDI   - CPBDI computes the determinant of a complex Hermitian positive
  849.      definite band matrix using the factors computed by CPBCO or CPBFA.  If
  850.      the inverse is needed, use CPBSL  N  times.
  851.  
  852.  
  853.  
  854.  
  855.                                                                        PPPPaaaaggggeeee 11113333
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  863.  
  864.  
  865.  
  866.      CPBFA   - CPBFA factors a complex Hermitian positive definite matrix
  867.      stored in band form.
  868.  
  869.      CPBSL   - CPBSL solves the complex Hermitian positive definite band
  870.      system  A*X = B using the factors computed by CPBCO or CPBFA.
  871.  
  872.      CPOCO   - CPOCO factors a complex Hermitian positive definite matrix and
  873.      estimates the condition of the matrix.
  874.  
  875.      CPODI   - CPODI computes the determinant and inverse of a certain complex
  876.      Hermitian positive definite matrix (see below) using the factors computed
  877.      by CPOCO, CPOFA or CQRDC.
  878.  
  879.      CPOFA   - CPOFA factors a complex Hermitian positive definite matrix.
  880.  
  881.      CPOSL   - CPOSL solves the COMPLEX Hermitian positive definite system A *
  882.      X = B using the factors computed by CPOCO or CPOFA.
  883.  
  884.      CPPCO   - CPPCO factors a complex Hermitian positive definite matrix
  885.      stored in packed form and estimates the condition of the matrix.
  886.  
  887.      CPPDI   - CPPDI computes the determinant and inverse of a complex
  888.      Hermitian positive definite matrix using the factors computed by CPPCO or
  889.      CPPFA .
  890.  
  891.      CPPFA   - CPPFA factors a complex Hermitian positive definite matrix
  892.      stored in packed form.
  893.  
  894.      CPPSL   - CPPSL solves the complex Hermitian positive definite system A *
  895.      X = B using the factors computed by CPPCO or CPPFA.
  896.  
  897.      CPTSL   - CPTSL given a positive definite tridiagonal matrix and a right
  898.      hand side will find the solution.
  899.  
  900.      CQRDC   - CQRDC uses Householder transformations to compute the QR
  901.      factorization of an N by P matrix X.  Column pivoting based on the 2-
  902.      norms of the reduced columns may be performed at the users option.
  903.  
  904.      CQRSL   - CQRSL applies the output of CQRDC to compute coordinate
  905.      transformations, projections, and least squares solutions.  For K .LE.
  906.      MIN(N,P), let XK be the matrix
  907.  
  908.         XK = (X(JVPT(1)),X(JVPT(2)), ... ,X(JVPT(K)))
  909.  
  910.      formed from columnns JVPT(1), ... ,JVPT(K) of the original N x P matrix X
  911.      that was input to CQRDC (if no pivoting was done, XK consists of the
  912.      first K columns of X in their original order).  CQRDC produces a factored
  913.      unitary matrix Q and an upper triangular matrix R such that
  914.  
  915.         XK = Q * (R)
  916.         (0)
  917.  
  918.  
  919.  
  920.  
  921.                                                                        PPPPaaaaggggeeee 11114444
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  929.  
  930.  
  931.  
  932.      This information is contained in coded form in the arrays X and QRAUX.
  933.  
  934.      CSICO   - CSICO factors a complex symmetric matrix by elimination with
  935.      symmetric pivoting and estimates the condition of the matrix.
  936.  
  937.      CSIDI   - CSIDI computes the determinant and inverse of a complex
  938.      symmetric matrix using the factors from CSIFA.
  939.  
  940.      CSIFA   - CSIFA factors a complex symmetric matrix by elimination with
  941.      symmetric pivoting.
  942.  
  943.      CSISL   - CSISL solves the complex symmetric system A * X = B using the
  944.      factors computed by CSIFA.
  945.  
  946.      CSPCO   - CSPCO factors a complex symmetric matrix stored in packed form
  947.      by elimination with symmetric pivoting and estimates the condition of the
  948.      matrix.
  949.  
  950.      CSPDI   - CSPDI computes the determinant and inverse of a complex
  951.      symmetric matrix using the factors from CSPFA, where the matrix is stored
  952.      in packed form.
  953.  
  954.      CSPFA   - CSPFA factors a complex symmetric matrix stored in packed form
  955.      by elimination with symmetric pivoting.
  956.  
  957.      CSPSL   - CSISL solves the complex symmetric system A * X = B using the
  958.      factors computed by CSPFA.
  959.  
  960.      CSVDC   - CSVDC is a subroutine to reduce a complex NxP matrix X by
  961.      unitary transformations U and V to diagonal form.  The diagonal elements
  962.      S(I) are the singular values of X.  The columns of U are the
  963.      corresponding left singular vectors, and the columns of V the right
  964.      singular vectors.
  965.  
  966.      CTRCO   - CTRCO estimates the condition of a complex triangular matrix.
  967.  
  968.      CTRDI   - CTRDI computes the determinant and inverse of a complex
  969.      triangular matrix.
  970.  
  971.      CTRSL   - CTRSL solves systems of the form
  972.  
  973.         T * X = B or
  974.         CTRANS(T) * X = B
  975.  
  976.      where T is a triangular matrix of order N.  Here CTRANS(T) denotes the
  977.      conjugate transpose of the matrix T.
  978.  
  979.      DCHDC   - DCHDC computes the Cholesky decomposition of a positive
  980.      definite matrix.  A pivoting option allows the user to estimate the
  981.      condition of a positive definite matrix or determine the rank of a
  982.      positive semidefinite matrix.
  983.  
  984.  
  985.  
  986.  
  987.                                                                        PPPPaaaaggggeeee 11115555
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  995.  
  996.  
  997.  
  998.      DCHDD   - DCHDD downdates an augmented Cholesky decomposition or the
  999.      triangular factor of an augmented QR decomposition.  Specifically, given
  1000.      an upper triangular matrix R of order P,  a row vector X, a column vector
  1001.      Z, and a scalar Y, DCHDD determines an orthogonal matrix U and a scalar
  1002.      ZETA such that
  1003.  
  1004.         (R   Z )     (RR  ZZ)
  1005.         U * (      )  =  (      ) ,
  1006.         (0 ZETA)     ( X   Y)
  1007.  
  1008.      where RR is upper triangular.  If R and Z have been obtained from the
  1009.      factorization of a least squares problem, then RR and ZZ are the factors
  1010.      corresponding to the problem with the observation (X,Y) removed.  In this
  1011.      case, if RHO is the norm of the residual vector, then the norm of the
  1012.      residual vector of the downdated problem is DSQRT(RHO**2 - ZETA**2).
  1013.      DCHDD will simultaneously downdate several triplets (Z,Y,RHO) along with
  1014.      R.  For a less terse description of what DCHDD does and how it may be
  1015.      applied, see the LINPACK guide.
  1016.  
  1017.      DCHEX   - DCHEX updates the Cholesky factorization
  1018.  
  1019.         A = TRANS(R)*R
  1020.  
  1021.      of a positive definite matrix A of order P under diagonal permutations of
  1022.      the form
  1023.  
  1024.         TRANS(E)*A*E
  1025.  
  1026.      where E is a permutation matrix.  Specifically, given an upper triangular
  1027.      matrix R and a permutation matrix E (which is specified by K, L, and
  1028.      JOB), DCHEX determines an orthogonal matrix U such that
  1029.  
  1030.         U*R*E = RR,
  1031.  
  1032.      where RR is upper triangular.  At the users option, the transformation U
  1033.      will be multiplied into the array Z.  If A = TRANS(X)*X, so that R is the
  1034.      triangular part of the QR factorization of X, then RR is the triangular
  1035.      part of the QR factorization of X*E, i.e. X with its columns permuted.
  1036.      For a less terse description of what DCHEX does and how it may be
  1037.      applied, see the LINPACK guide.
  1038.  
  1039.      DCHUD   - DCHUD updates an augmented Cholesky decomposition of the
  1040.      triangular part of an augmented QR decomposition.  Specifically, given an
  1041.      upper triangular matrix R of order P, a row vector X, a column vector Z,
  1042.      and a scalar Y, DCHUD determines a untiary matrix U and a scalar ZETA
  1043.      such that
  1044.  
  1045.  
  1046.         (R  Z)     (RR   ZZ )
  1047.         U  * (    )  =  (        ) ,
  1048.         (X  Y)     ( 0  ZETA)
  1049.  
  1050.  
  1051.  
  1052.  
  1053.                                                                        PPPPaaaaggggeeee 11116666
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  1061.  
  1062.  
  1063.  
  1064.      where RR is upper triangular.  If R and Z have been obtained from the
  1065.      factorization of a least squares problem, then RR and ZZ are the factors
  1066.      corresponding to the problem with the observation (X,Y) appended.  In
  1067.      this case, if RHO is the norm of the residual vector, then the norm of
  1068.      the residual vector of the updated problem is DSQRT(RHO**2 + ZETA**2).
  1069.      DCHUD will simultaneously update several triplets (Z,Y,RHO).  For a less
  1070.      terse description of what DCHUD does and how it may be applied, see the
  1071.      LINPACK guide.
  1072.  
  1073.      DGBCO   - DGBCO factors a double precision band matrix by Gaussian
  1074.      elimination and estimates the condition of the matrix.
  1075.  
  1076.      DGBDI   - DGBDI computes the determinant of a band matrix using the
  1077.      factors computed by DGBCO or DGBFA.  If the inverse is needed, use DGBSL
  1078.      N  times.
  1079.  
  1080.      DGBFA   - DGBFA factors a double precision band matrix by elimination.
  1081.  
  1082.      DGBSL   - DGBSL solves the double precision band system A * X = B  or
  1083.      TRANS(A) * X = B using the factors computed by DGBCO or DGBFA.
  1084.  
  1085.      DGECO   - DGECO factors a double precision matrix by Gaussian elimination
  1086.      and estimates the condition of the matrix.
  1087.  
  1088.      DGEDI   - DGEDI computes the determinant and inverse of a matrix using
  1089.      the factors computed by DGECO or DGEFA.
  1090.  
  1091.      DGEFA   - DGEFA factors a double precision matrix by Gaussian
  1092.      elimination.
  1093.  
  1094.      DGESL   - DGESL solves the double precision system A * X = B  or
  1095.      TRANS(A) * X = B using the factors computed by DGECO or DGEFA.
  1096.  
  1097.      DGTSL   - DGTSL given a general tridiagonal matrix and a right hand side
  1098.      will find the solution.
  1099.  
  1100.      DPBCO   - DPBCO factors a double precision symmetric positive definite
  1101.      matrix stored in band form and estimates the condition of the matrix.
  1102.  
  1103.      DPBDI   - DPBDI computes the determinant of a double precision symmetric
  1104.      positive definite band matrix using the factors computed by DPBCO or
  1105.      DPBFA.  If the inverse is needed, use DPBSL  N  times.
  1106.  
  1107.      DPBFA   - DPBFA factors a double precision symmetric positive definite
  1108.      matrix stored in band form.
  1109.  
  1110.      DPBSL   - DPBSL solves the double precision symmetric positive definite
  1111.      band system  A*X = B using the factors computed by DPBCO or DPBFA.
  1112.  
  1113.      DPOCO   - DPOCO factors a double precision symmetric positive definite
  1114.      matrix and estimates the condition of the matrix.
  1115.  
  1116.  
  1117.  
  1118.  
  1119.                                                                        PPPPaaaaggggeeee 11117777
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  1127.  
  1128.  
  1129.  
  1130.      DPODI   - DPODI computes the determinant and inverse of a certain double
  1131.      precision symmetric positive definite matrix (see below) using the
  1132.      factors computed by DPOCO, DPOFA or DQRDC.
  1133.  
  1134.      DPOFA   - DPOFA factors a double precision symmetric positive definite
  1135.      matrix.
  1136.  
  1137.      DPOSL   - DPOSL solves the double precision symmetric positive definite
  1138.      system A * X = B using the factors computed by DPOCO or DPOFA.
  1139.  
  1140.      DPPCO   - DPPCO factors a double precision symmetric positive definite
  1141.      matrix stored in packed form and estimates the condition of the matrix.
  1142.  
  1143.      DPPDI   - DPPDI computes the determinant and inverse of a double
  1144.      precision symmetric positive definite matrix using the factors computed
  1145.      by DPPCO or DPPFA .
  1146.  
  1147.      DPPFA   - DPPFA factors a double precision symmetric positive definite
  1148.      matrix stored in packed form.
  1149.  
  1150.      DPPSL   - DPPSL solves the double precision symmetric positive definite
  1151.      system A * X = B using the factors computed by DPPCO or DPPFA.
  1152.  
  1153.      DPTSL   - DPTSL, given a positive definite symmetric tridiagonal matrix
  1154.      and a right hand side, will find the solution.
  1155.  
  1156.      DQRDC   - DQRDC uses Householder transformations to compute the QR
  1157.      factorization of an N by P matrix X.  Column pivoting based on the 2-
  1158.      norms of the reduced columns may be performed at the user's option.
  1159.  
  1160.      DQRSL   - DQRSL applies the output of DQRDC to compute coordinate
  1161.      transformations, projections, and least squares solutions.  For K .LE.
  1162.      MIN(N,P), let XK be the matrix
  1163.  
  1164.         XK = (X(JPVT(1)),X(JPVT(2)), ... ,X(JPVT(K)))
  1165.  
  1166.      formed from columnns JPVT(1), ... ,JPVT(K) of the original N X P matrix X
  1167.      that was input to DQRDC (if no pivoting was done, XK consists of the
  1168.      first K columns of X in their original order).  DQRDC produces a factored
  1169.      orthogonal matrix Q and an upper triangular matrix R such that
  1170.  
  1171.         XK = Q * (R)
  1172.         (0)
  1173.  
  1174.      This information is contained in coded form in the arrays X and QRAUX.
  1175.  
  1176.      DSICO   - DSICO factors a double precision symmetric matrix by
  1177.      elimination with symmetric pivoting and estimates the condition of the
  1178.      matrix.
  1179.  
  1180.      DSIDI   - DSIDI computes the determinant, inertia and inverse of a double
  1181.      precision symmetric matrix using the factors from DSIFA.
  1182.  
  1183.  
  1184.  
  1185.                                                                        PPPPaaaaggggeeee 11118888
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  1193.  
  1194.  
  1195.  
  1196.      DSIFA   - DSIFA factors a double precision symmetric matrix by
  1197.      elimination with symmetric pivoting.
  1198.  
  1199.      DSISL   - DSISL solves the double precision symmetric system A * X = B
  1200.      using the factors computed by DSIFA.
  1201.  
  1202.      DSPCO   - DSPCO factors a double precision symmetric matrix stored in
  1203.      packed form by elimination with symmetric pivoting and estimates the
  1204.      condition of the matrix.
  1205.  
  1206.      DSPDI   - DSPDI computes the determinant, inertia and inverse of a double
  1207.      precision symmetric matrix using the factors from DSPFA, where the matrix
  1208.      is stored in packed form.
  1209.  
  1210.      DSPFA   - DSPFA factors a double precision symmetric matrix stored in
  1211.      packed form by elimination with symmetric pivoting.
  1212.  
  1213.      DSPSL   - DSISL solves the double precision symmetric system A * X = B
  1214.      using the factors computed by DSPFA.
  1215.  
  1216.      DSVDC   - DSVDC is a subroutine to reduce a double precision NxP matrix X
  1217.      by orthogonal transformations U and V to diagonal form.  The diagonal
  1218.      elements S(I) are the singular values of X.  The columns of U are the
  1219.      corresponding left singular vectors, and the columns of V the right
  1220.      singular vectors.
  1221.  
  1222.      DTRCO   - DTRCO estimates the condition of a double precision triangular
  1223.      matrix.
  1224.  
  1225.      DTRDI   - DTRDI computes the determinant and inverse of a double
  1226.      precision triangular matrix.
  1227.  
  1228.      DTRSL   - DTRSL solves systems of the form
  1229.  
  1230.         T * X = B or
  1231.         TRANS(T) * X = B
  1232.  
  1233.      where T is a triangular matrix of order N.  Here TRANS(T) denotes the
  1234.      transpose of the matrix T.
  1235.  
  1236.      SCHDC   - SCHDC computes the Cholesky decomposition of a positive
  1237.      definite matrix.  A pivoting option allows the user to estimate the
  1238.      condition of a positive definite matrix or determine the rank of a
  1239.      positive semidefinite matrix.
  1240.  
  1241.      SCHDD   - SCHDD downdates an augmented Cholesky decomposition or the
  1242.      triangular factor of an augmented QR decomposition.  Specifically, given
  1243.      an upper triangular matrix R of order P, a row vector X, a column vector
  1244.      Z, and a scalar Y, SCHDD determines an orthogonal matrix U and a scalar
  1245.      ZETA such that
  1246.  
  1247.         (R   Z )     (RR  ZZ)
  1248.  
  1249.  
  1250.  
  1251.                                                                        PPPPaaaaggggeeee 11119999
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  1259.  
  1260.  
  1261.  
  1262.         U * (      )  =  (      ) ,
  1263.         (0 ZETA)     ( X   Y)
  1264.  
  1265.      where RR is upper triangular.  If R and Z have been obtained from the
  1266.      factorization of a least squares problem, then RR and ZZ are the factors
  1267.      corresponding to the problem with the observation (X,Y) removed.  In this
  1268.      case, if RHO is the norm of the residual vector, then the norm of the
  1269.      residual vector of the downdated problem is SQRT(RHO**2 - ZETA**2). SCHDD
  1270.      will simultaneously downdate several triplets (Z,Y,RHO) along with R.
  1271.      For a less terse description of what SCHDD does and how it may be
  1272.      applied, see the LINPACK guide.
  1273.  
  1274.      SCHEX   - SCHEX updates the Cholesky factorization
  1275.  
  1276.         A = TRANS(R)*R
  1277.  
  1278.      of a positive definite matrix A of order P under diagonal permutations of
  1279.      the form
  1280.  
  1281.         TRANS(E)*A*E
  1282.  
  1283.      where E is a permutation matrix.  Specifically, given an upper triangular
  1284.      matrix R and a permutation matrix E (which is specified by K, L, and
  1285.      JOB), SCHEX determines an orthogonal matrix U such that
  1286.  
  1287.         U*R*E = RR,
  1288.  
  1289.      where RR is upper triangular.  At the users option, the transformation U
  1290.      will be multiplied into the array Z.  If A = TRANS(X)*X, so that R is the
  1291.      triangular part of the QR factorization of X, then RR is the triangular
  1292.      part of the QR factorization of X*E, i.e., X with its columns permuted.
  1293.      For a less terse description of what SCHEX does and how it may be
  1294.      applied, see the LINPACK guide.
  1295.  
  1296.      SCHUD   - SCHUD updates an augmented Cholesky decomposition of the
  1297.      triangular part of an augmented QR decomposition.  Specifically, given an
  1298.      upper triangular matrix R of order P, a row vector X, a column vector Z,
  1299.      and a scalar Y, SCHUD determines a unitary matrix U and a scalar ZETA
  1300.      such that
  1301.  
  1302.  
  1303.         (R  Z)     (RR   ZZ )
  1304.         U  * (    )  =  (        ) ,
  1305.         (X  Y)     ( 0  ZETA)
  1306.  
  1307.      where RR is upper triangular.  If R and Z have been obtained from the
  1308.      factorization of a least squares problem, then RR and ZZ are the factors
  1309.      corresponding to the problem with the observation (X,Y) appended.  In
  1310.      this case, if RHO is the norm of the residual vector, then the norm of
  1311.      the residual vector of the updated problem is SQRT(RHO**2 + ZETA**2).
  1312.      SCHUD will simultaneously update several triplets (Z,Y,RHO).  For a less
  1313.      terse description of what SCHUD does and how it may be applied, see the
  1314.  
  1315.  
  1316.  
  1317.                                                                        PPPPaaaaggggeeee 22220000
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  1325.  
  1326.  
  1327.  
  1328.      LINPACK guide.
  1329.  
  1330.      SGBCO   - SBGCO factors a real band matrix by Gaussian elimination and
  1331.      estimates the condition of the matrix.
  1332.  
  1333.      SGBDI   - SGBDI computes the determinant of a band matrix using the
  1334.      factors computed by SBGCO or SGBFA.  If the inverse is needed, use SGBSL
  1335.      N  times.
  1336.  
  1337.      SGBFA   - SGBFA factors a real band matrix by elimination.
  1338.  
  1339.      SGBSL   - SGBSL solves the real band system A * X = B  or  TRANS(A) * X =
  1340.      B using the factors computed by SBGCO or SGBFA.
  1341.  
  1342.      SGECO   - SGECO factors a real matrix by Gaussian elimination and
  1343.      estimates the condition of the matrix.
  1344.  
  1345.      SGEDI   - SGEDI computes the determinant and inverse of a matrix using
  1346.      the factors computed by SGECO or SGEFA.
  1347.  
  1348.      SGEFA   - SGEFA factors a real matrix by Gaussian elimination.
  1349.  
  1350.      SGESL   - SGESL solves the real system A * X = B  or  TRANS(A) * X = B
  1351.      using the factors computed by SGECO or SGEFA.
  1352.  
  1353.      SGTSL   - SGTSL given a general tridiagonal matrix and a right hand side
  1354.      will find the solution.
  1355.  
  1356.      SPBCO   - SPBCO factors a real symmetric positive definite matrix stored
  1357.      in band form and estimates the condition of the matrix.
  1358.  
  1359.      SPBDI   - SPBDI computes the determinant of a real symmetric positive
  1360.      definite band matrix using the factors computed by SPBCO or SPBFA.  If
  1361.      the inverse is needed, use SPBSL  N  times.
  1362.  
  1363.      SPBFA   - SPBFA factors a real symmetric positive definite matrix stored
  1364.      in band form.
  1365.  
  1366.      SPBSL   - SPBSL solves the real symmetric positive definite band system
  1367.      A*X = B using the factors computed by SPBCO or SPBFA.
  1368.  
  1369.      SPOCO   - SPOCO factors a real symmetric positive definite matrix and
  1370.      estimates the condition of the matrix.
  1371.  
  1372.      SPODI   - SPODI computes the determinant and inverse of a certain real
  1373.      symmetric positive definite matrix (see below) using the factors computed
  1374.      by SPOCO, SPOFA or SQRDC.
  1375.  
  1376.      SPOFA   - SPOFA factors a real symmetric positive definite matrix.
  1377.  
  1378.      SPOSL   - SPOSL solves the real symmetric positive definite system A * X
  1379.      = B using the factors computed by SPOCO or SPOFA.
  1380.  
  1381.  
  1382.  
  1383.                                                                        PPPPaaaaggggeeee 22221111
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  1391.  
  1392.  
  1393.  
  1394.      SPPCO   - SPPCO factors a real symmetric positive definite matrix stored
  1395.      in packed form and estimates the condition of the matrix.
  1396.  
  1397.      SPPDI   - SPPDI computes the determinant and inverse of a real symmetric
  1398.      positive definite matrix using the factors computed by SPPCO or SPPFA .
  1399.  
  1400.      SPPFA   - SPPFA factors a real symmetric positive definite matrix stored
  1401.      in packed form.
  1402.  
  1403.      SPPSL   - SPPSL solves the real symmetric positive definite system A * X
  1404.      = B using the factors computed by SPPCO or SPPFA.
  1405.  
  1406.      SPTSL   - SPTSL given a positive definite tridiagonal matrix and a right
  1407.      hand side will find the solution.
  1408.  
  1409.      SQRDC   - SQRDC uses Householder transformations to compute the QR
  1410.      factorization of an N by P matrix X.  Column pivoting based on the 2-
  1411.      norms of the reduced columns may be performed at the user's option.
  1412.  
  1413.      SQRSL   - SQRSL applies the output of SQRDC to compute coordinate
  1414.      transformations, projections, and least squares solutions.  For K .LE.
  1415.      MIN(N,P), let XK be the matrix
  1416.  
  1417.         XK = (X(JPVT(1)),X(JPVT(2)), ... ,X(JPVT(K)))
  1418.  
  1419.      formed from columnns JPVT(1), ... ,JPVT(K) of the original N x P matrix X
  1420.      that was input to SQRDC (if no pivoting was done, XK consists of the
  1421.      first K columns of X in their original order).  SQRDC produces a factored
  1422.      orthogonal matrix Q and an upper triangular matrix R such that
  1423.  
  1424.         XK = Q * (R)
  1425.         (0)
  1426.  
  1427.      This information is contained in coded form in the arrays X and QRAUX.
  1428.  
  1429.      SSICO   - SSICO factors a real symmetric matrix by elimination with
  1430.      symmetric pivoting and estimates the condition of the matrix.
  1431.  
  1432.      SSIDI   - SSIDI computes the determinant, inertia and inverse of a real
  1433.      symmetric matrix using the factors from SSIFA.
  1434.  
  1435.      SSIFA   - SSIFA factors a real symmetric matrix by elimination with
  1436.      symmetric pivoting.
  1437.  
  1438.      SSISL   - SSISL solves the real symmetric system A * X = B using the
  1439.      factors computed by SSIFA.
  1440.  
  1441.      SSPCO   - SSPCO factors a real symmetric matrix stored in packed form by
  1442.      elimination with symmetric pivoting and estimates the condition of the
  1443.      matrix.
  1444.  
  1445.      SSPDI   - SSPDI computes the determinant, inertia and inverse of a real
  1446.  
  1447.  
  1448.  
  1449.                                                                        PPPPaaaaggggeeee 22222222
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  1457.  
  1458.  
  1459.  
  1460.      symmetric matrix using the factors from SSPFA, where the matrix is stored
  1461.      in packed form.
  1462.  
  1463.      SSPFA   - SSPFA factors a real symmetric matrix stored in packed form by
  1464.      elimination with symmetric pivoting.
  1465.  
  1466.      SSPSL   - SSISL solves the real symmetric system A * X = B using the
  1467.      factors computed by SSPFA.
  1468.  
  1469.      SSVDC   - SSVDC is a subroutine to reduce a real NxP matrix X by
  1470.      orthogonal transformations U and V to diagonal form.  The diagonal
  1471.      elements S(I) are the singular values of X.  The columns of U are the
  1472.      corresponding left singular vectors, and the columns of V the right
  1473.      singular vectors.
  1474.  
  1475.      STRCO   - STRCO estimates the condition of a real triangular matrix.
  1476.  
  1477.      STRDI   - STRDI computes the determinant and inverse of a real triangular
  1478.      matrix.
  1479.  
  1480.      STRSL   - STRSL solves systems of the form
  1481.  
  1482.         T * X = B or
  1483.         TRANS(T) * X = B
  1484.  
  1485.      where T is a triangular matrix of order N.  Here TRANS(T) denotes the
  1486.      transpose of the matrix T.
  1487.  
  1488.      LLLLAAAAPPPPAAAACCCCKKKK LLLLIIIIBBBBRRRRAAAARRRRYYYY
  1489.  
  1490.      SBDSQR computes the singular value decomposition (SVD) of a real N-by-N
  1491.      (upper or lower) bidiagonal matrix B:  B = Q * S * P' (P' denotes the
  1492.      transpose of P), where S is a diagonal matrix with non-negative diagonal
  1493.      elements (the singular values of B), and Q and P are orthogonal matrices.
  1494.  
  1495.      CGBCON estimates the reciprocal of the condition number of a complex
  1496.      general band matrix A, in either the 1-norm or the infinity-norm, using
  1497.      the LU factorization computed by CGBTRF.
  1498.  
  1499.      CGBEQU computes row and column scalings intended to equilibrate an M by N
  1500.      band matrix A and reduce its condition number.  R returns the row scale
  1501.      factors and C the column scale factors, chosen to try to make the largest
  1502.      element in each row and column of the matrix B with elements
  1503.      B(i,j)=R(i)*A(i,j)*C(j) have absolute value 1.
  1504.  
  1505.      CGBRFS improves the computed solution to a system of linear equations
  1506.      when the coefficient matrix is banded, and provides error bounds and
  1507.      backward error estimates for the solution.
  1508.  
  1509.      CGBSV computes the solution to a complex system of linear equations A * X
  1510.      = B, where A is a band matrix of order N with KL subdiagonals and KU
  1511.      superdiagonals, and X and B are N-by-NRHS matrices.
  1512.  
  1513.  
  1514.  
  1515.                                                                        PPPPaaaaggggeeee 22223333
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  1523.  
  1524.  
  1525.  
  1526.      CGBSVX uses the LU factorization to compute the solution to a complex
  1527.      system of linear equations A * X = B, A**T * X = B, or A**H * X = B,
  1528.      where A is a band matrix of order N with KL subdiagonals and KU
  1529.      superdiagonals, and X and B are N-by-NRHS matrices.
  1530.  
  1531.      CGBTF2 computes an LU factorization of a complex m-by-n band matrix A
  1532.      using partial pivoting with row interchanges.
  1533.  
  1534.      CGBTRF computes an LU factorization of a complex m-by-n band matrix A
  1535.      using partial pivoting with row interchanges.
  1536.  
  1537.      CGBTRS solves a system of linear equations
  1538.         A * X = B,  A**T * X = B,  or  A**H * X = B with a general band matrix
  1539.      A using the LU factorization computed by CGBTRF.
  1540.  
  1541.      CGEBAK forms the right or left eigenvectors of a complex general matrix
  1542.      by backward transformation on the computed eigenvectors of the balanced
  1543.      matrix output by CGEBAL.
  1544.  
  1545.      CGEBAL balances a general complex matrix A.  This involves, first,
  1546.      permuting A by a similarity transformation to isolate eigenvalues in the
  1547.      first 1 to ILO-1 and last IHI+1 to N elements on the diagonal; and
  1548.      second, applying a diagonal similarity transformation to rows and columns
  1549.      ILO to IHI to make the rows and columns as close in norm as possible.
  1550.      Both steps are optional.
  1551.  
  1552.      CGEBD2 reduces a complex general m by n matrix A to upper or lower real
  1553.      bidiagonal form B by a unitary transformation: Q' * A * P = B.
  1554.  
  1555.      CGEBRD reduces a general complex M-by-N matrix A to upper or lower
  1556.      bidiagonal form B by a unitary transformation: Q**H * A * P = B.
  1557.  
  1558.      CGECON estimates the reciprocal of the condition number of a general
  1559.      complex matrix A, in either the 1-norm or the infinity-norm, using the LU
  1560.      factorization computed by CGETRF.
  1561.  
  1562.      CGEEQU computes row and column scalings intended to equilibrate an M by N
  1563.      matrix A and reduce its condition number.  R returns the row scale
  1564.      factors and C the column scale factors, chosen to try to make the largest
  1565.      entry in each row and column of the matrix B with elements
  1566.      B(i,j)=R(i)*A(i,j)*C(j) have absolute value 1.
  1567.  
  1568.      CGEES computes for an N-by-N complex nonsymmetric matrix A, the
  1569.      eigenvalues, the Schur form T, and, optionally, the matrix of Schur
  1570.      vectors Z.  This gives the Schur factorization A = Z*T*(Z**H).
  1571.  
  1572.      CGEESX computes for an N-by-N complex nonsymmetric matrix A, the
  1573.      eigenvalues, the Schur form T, and, optionally, the matrix of Schur
  1574.      vectors Z.  This gives the Schur factorization A = Z*T*(Z**H).
  1575.  
  1576.      CGEEV computes for an N-by-N complex nonsymmetric matrix A, the
  1577.      eigenvalues and, optionally, the left and/or right eigenvectors.
  1578.  
  1579.  
  1580.  
  1581.                                                                        PPPPaaaaggggeeee 22224444
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  1589.  
  1590.  
  1591.  
  1592.      CGEEVX computes for an N-by-N complex nonsymmetric matrix A, the
  1593.      eigenvalues and, optionally, the left and/or right eigenvectors.
  1594.  
  1595.      For a pair of N-by-N complex nonsymmetric matrices A, B:
  1596.  
  1597.         compute the generalized eigenvalues (alpha, beta)
  1598.  
  1599.      For a pair of N-by-N complex nonsymmetric matrices A, B:
  1600.  
  1601.         compute the generalized eigenvalues (alpha, beta)
  1602.  
  1603.      CGEHD2 reduces a complex general matrix A to upper Hessenberg form H by a
  1604.      unitary similarity transformation:  Q' * A * Q = H .
  1605.  
  1606.      CGEHRD reduces a complex general matrix A to upper Hessenberg form H by a
  1607.      unitary similarity transformation:  Q' * A * Q = H .
  1608.  
  1609.      CGELQ2 computes an LQ factorization of a complex m by n matrix A:  A = L
  1610.      * Q.
  1611.  
  1612.      CGELQF computes an LQ factorization of a complex M-by-N matrix A:  A = L
  1613.      * Q.
  1614.  
  1615.      CGELS solves overdetermined or underdetermined complex linear systems
  1616.      involving an M-by-N matrix A, or its conjugate-transpose, using a QR or
  1617.      LQ factorization of A.  It is assumed that A has full rank.
  1618.  
  1619.      CGELSS computes the minimum norm solution to a complex linear least
  1620.      squares problem:
  1621.  
  1622.      Minimize 2-norm(| b - A*x |).
  1623.  
  1624.      CGELSX computes the minimum-norm solution to a complex linear least
  1625.      squares problem:
  1626.          minimize || A * X - B ||
  1627.  
  1628.      CGEQL2 computes a QL factorization of a complex m by n matrix A:  A = Q *
  1629.      L.
  1630.  
  1631.      CGEQLF computes a QL factorization of a complex M-by-N matrix A:  A = Q *
  1632.      L.
  1633.  
  1634.      CGEQPF computes a QR factorization with column pivoting of a complex M-
  1635.      by-N matrix A: A*P = Q*R.
  1636.  
  1637.      CGEQR2 computes a QR factorization of a complex m by n matrix A:  A = Q *
  1638.      R.
  1639.  
  1640.      CGEQRF computes a QR factorization of a complex M-by-N matrix A:  A = Q *
  1641.      R.
  1642.  
  1643.      CGERFS improves the computed solution to a system of linear equations and
  1644.  
  1645.  
  1646.  
  1647.                                                                        PPPPaaaaggggeeee 22225555
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  1655.  
  1656.  
  1657.  
  1658.      provides error bounds and backward error estimates for the solution.
  1659.  
  1660.      CGERQ2 computes an RQ factorization of a complex m by n matrix A:  A = R
  1661.      * Q.
  1662.  
  1663.      CGERQF computes an RQ factorization of a complex M-by-N matrix A:  A = R
  1664.      * Q.
  1665.  
  1666.      CGESV computes the solution to a complex system of linear equations
  1667.         A * X = B, where A is an N-by-N matrix and X and B are N-by-NRHS
  1668.      matrices.
  1669.  
  1670.      CGESVD computes the singular value decomposition (SVD) of a complex M-
  1671.      by-N matrix A, optionally computing the left and/or right singular
  1672.      vectors. The SVD is written
  1673.  
  1674.           A = U * SIGMA * conjugate-transpose(V)
  1675.  
  1676.      CGESVX uses the LU factorization to compute the solution to a complex
  1677.      system of linear equations
  1678.         A * X = B, where A is an N-by-N matrix and X and B are N-by-NRHS
  1679.      matrices.
  1680.  
  1681.      CGETF2 computes an LU factorization of a general m-by-n matrix A using
  1682.      partial pivoting with row interchanges.
  1683.  
  1684.      CGETRF computes an LU factorization of a general M-by-N matrix A using
  1685.      partial pivoting with row interchanges.
  1686.  
  1687.      CGETRI computes the inverse of a matrix using the LU factorization
  1688.      computed by CGETRF.
  1689.  
  1690.      CGETRS solves a system of linear equations
  1691.         A * X = B,  A**T * X = B,  or  A**H * X = B with a general N-by-N
  1692.      matrix A using the LU factorization computed by CGETRF.
  1693.  
  1694.      CGGBAK forms the right or left eigenvectors of the generalized eigenvalue
  1695.      problem by backward transformation on the computed eigenvectors of the
  1696.      balanced matrix output by CGGBAL.
  1697.  
  1698.      CGGBAL balances a pair of general complex matrices (A,B) for the
  1699.      generalized eigenvalue problem A*X = lambda*B*X.  This involves, first,
  1700.      permuting A and B by similarity transformations to isolate eigenvalues in
  1701.      the first 1 to ILO-1 and last IHI+1 to N elements on the diagonal; and
  1702.      second, applying a diagonal similarity
  1703.  
  1704.      CGGGLM solves a generalized linear regression model (GLM) problem:
  1705.  
  1706.              minimize y'*y     subject to    d = A*x + B*y
  1707.  
  1708.      CGGHRD reduces a pair of complex matrices (A,B) to generalized upper
  1709.      Hessenberg form using unitary similarity transformations, where A is a
  1710.  
  1711.  
  1712.  
  1713.                                                                        PPPPaaaaggggeeee 22226666
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  1721.  
  1722.  
  1723.  
  1724.      (generally non-symmetric) square matrix and B is upper triangular.  More
  1725.      precisely, CGGHRD simultaneously decomposes  A into  Q H Z* and  B  into
  1726.      Q T Z* , where H is upper Hessenberg, T is upper triangular, Q and Z are
  1727.      unitary, and * means conjugate transpose.
  1728.  
  1729.      CGGLSE solves the linear equality constrained least squares (LSE)
  1730.      problem:
  1731.  
  1732.              minimize || A*x - c ||_2   subject to B*x = d
  1733.  
  1734.      CGGQRF computes a generalized QR factorization of an N-by-M matrix A and
  1735.      an N-by-P matrix B:
  1736.  
  1737.                  A = Q*R,        B = Q*T*Z,
  1738.  
  1739.      CGGRQF computes a generalized RQ factorization of an M-by-N matrix A and
  1740.      a P-by-N matrix B:
  1741.  
  1742.                  A = R*Q,        B = Z*T*Q,
  1743.  
  1744.      CGGSVD computes the generalized singular value decomposition (GSVD) of
  1745.      the M-by-N complex matrix A and P-by-N complex matrix B:
  1746.  
  1747.            U'*A*Q = D1*( 0 R ),    V'*B*Q = D2*( 0 R )               (1)
  1748.  
  1749.      where U, V and Q are unitary matrices, R is an upper triangular matrix,
  1750.      and Z' means the conjugate transpose of Z.  Let K+L = the numerical
  1751.      effective rank of the matrix (A',B')', then D1 and D2 are M-by-(K+L) and
  1752.      P-by-(K+L) "diagonal" matrices and of the following structures,
  1753.      respectively:
  1754.  
  1755.      CGGSVP computes unitary matrices U, V and Q such that A23 is upper
  1756.      trapezoidal.  K+L = the effective rank of the (M+P)-by-N matrix (A',B')'.
  1757.      Z' denotes the conjugate transpose of Z.
  1758.  
  1759.      CGTCON estimates the reciprocal of the condition number of a complex
  1760.      tridiagonal matrix A using the LU factorization as computed by CGTTRF.
  1761.  
  1762.      CGTRFS improves the computed solution to a system of linear equations
  1763.      when the coefficient matrix is tridiagonal, and provides error bounds and
  1764.      backward error estimates for the solution.
  1765.  
  1766.      CGTSV  solves the equation
  1767.  
  1768.      where A is an N-by-N tridiagonal matrix, by Gaussian elimination with
  1769.      partial pivoting.
  1770.  
  1771.      CGTSVX uses the LU factorization to compute the solution to a complex
  1772.      system of linear equations A * X = B, A**T * X = B, or A**H * X = B,
  1773.      where A is a tridiagonal matrix of order N and X and B are N-by-NRHS
  1774.      matrices.
  1775.  
  1776.  
  1777.  
  1778.  
  1779.                                                                        PPPPaaaaggggeeee 22227777
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  1787.  
  1788.  
  1789.  
  1790.      CGTTRF computes an LU factorization of a complex tridiagonal matrix A
  1791.      using elimination with partial pivoting and row interchanges.
  1792.  
  1793.      CGTTRS solves one of the systems of equations
  1794.         A * X = B,  A**T * X = B,  or  A**H * X = B, with a tridiagonal matrix
  1795.      A using the LU factorization computed by CGTTRF.
  1796.  
  1797.      CHBEV computes all the eigenvalues and, optionally, eigenvectors of a
  1798.      complex Hermitian band matrix A.
  1799.  
  1800.      CHBEVX computes selected eigenvalues and, optionally, eigenvectors of a
  1801.      complex Hermitian band matrix A.  Eigenvalues/vectors can be selected by
  1802.      specifying either a range of values or a range of indices for the desired
  1803.      eigenvalues.
  1804.  
  1805.      CHBTRD reduces a complex Hermitian band matrix A to real symmetric
  1806.      tridiagonal form T by a unitary similarity transformation:  Q**H * A * Q
  1807.      = T.
  1808.  
  1809.      CHECON estimates the reciprocal of the condition number of a complex
  1810.      Hermitian matrix A using the factorization A = U*D*U**H or A = L*D*L**H
  1811.      computed by CHETRF.
  1812.  
  1813.      CHEEV computes all eigenvalues and, optionally, eigenvectors of a complex
  1814.      Hermitian matrix A.
  1815.  
  1816.      CHEEVX computes selected eigenvalues and, optionally, eigenvectors of a
  1817.      complex Hermitian matrix A.  Eigenvalues and eigenvectors can be selected
  1818.      by specifying either a range of values or a range of indices for the
  1819.      desired eigenvalues.
  1820.  
  1821.      CHEGS2 reduces a complex Hermitian-definite generalized eigenproblem to
  1822.      standard form.
  1823.  
  1824.      CHEGST reduces a complex Hermitian-definite generalized eigenproblem to
  1825.      standard form.
  1826.  
  1827.      CHEGV computes all the eigenvalues, and optionally, the eigenvectors of a
  1828.      complex generalized Hermitian-definite eigenproblem, of the form
  1829.      A*x=(lambda)*B*x,  A*Bx=(lambda)*x,  or B*A*x=(lambda)*x.  Here A and B
  1830.      are assumed to be Hermitian and B is also
  1831.  
  1832.      CHERFS improves the computed solution to a system of linear equations
  1833.      when the coefficient matrix is Hermitian indefinite, and provides error
  1834.      bounds and backward error estimates for the solution.
  1835.  
  1836.      CHESV computes the solution to a complex system of linear equations
  1837.         A * X = B, where A is an N-by-N Hermitian matrix and X and B are N-
  1838.      by-NRHS matrices.
  1839.  
  1840.      CHESVX uses the diagonal pivoting factorization to compute the solution
  1841.      to a complex system of linear equations A * X = B, where A is an N-by-N
  1842.  
  1843.  
  1844.  
  1845.                                                                        PPPPaaaaggggeeee 22228888
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  1853.  
  1854.  
  1855.  
  1856.      Hermitian matrix and X and B are N-by-NRHS matrices.
  1857.  
  1858.      CHETD2 reduces a complex Hermitian matrix A to real symmetric tridiagonal
  1859.      form T by a unitary similarity transformation:  Q' * A * Q = T.
  1860.  
  1861.      CHETF2 computes the factorization of a complex Hermitian matrix A using
  1862.      the Bunch-Kaufman diagonal pivoting method:
  1863.  
  1864.         A = U*D*U'  or  A = L*D*L'
  1865.  
  1866.      CHETRD reduces a complex Hermitian matrix A to real symmetric tridiagonal
  1867.      form T by a unitary similarity transformation:  Q**H * A * Q = T.
  1868.  
  1869.      CHETRF computes the factorization of a complex Hermitian matrix A using
  1870.      the Bunch-Kaufman diagonal pivoting method.  The form of the
  1871.      factorization is
  1872.  
  1873.      CHETRI computes the inverse of a complex Hermitian indefinite matrix A
  1874.      using the factorization A = U*D*U**H or A = L*D*L**H computed by CHETRF.
  1875.  
  1876.      CHETRS solves a system of linear equations A*X = B with a complex
  1877.      Hermitian matrix A using the factorization A = U*D*U**H or A = L*D*L**H
  1878.      computed by CHETRF.
  1879.  
  1880.      CHGEQZ implements a single-shift version of the QZ method for finding the
  1881.      generalized eigenvalues w(i)=ALPHA(i)/BETA(i) of the equation A are then
  1882.      ALPHA(1),...,ALPHA(N), and of B are BETA(1),...,BETA(N).
  1883.  
  1884.      CHPCON estimates the reciprocal of the condition number of a complex
  1885.      Hermitian packed matrix A using the factorization A = U*D*U**H or A =
  1886.      L*D*L**H computed by CHPTRF.
  1887.  
  1888.      CHPEV computes all the eigenvalues and, optionally, eigenvectors of a
  1889.      complex Hermitian matrix in packed storage.
  1890.  
  1891.      CHPEVX computes selected eigenvalues and, optionally, eigenvectors of a
  1892.      complex Hermitian matrix A in packed storage.  Eigenvalues/vectors can be
  1893.      selected by specifying either a range of values or a range of indices for
  1894.      the desired eigenvalues.
  1895.  
  1896.      CHPGST reduces a complex Hermitian-definite generalized eigenproblem to
  1897.      standard form, using packed storage.
  1898.  
  1899.      CHPGV computes all the eigenvalues and, optionally, the eigenvectors of a
  1900.      complex generalized Hermitian-definite eigenproblem, of the form
  1901.      A*x=(lambda)*B*x,  A*Bx=(lambda)*x,  or B*A*x=(lambda)*x.  Here A and B
  1902.      are assumed to be Hermitian, stored in packed format, and B is also
  1903.      positive definite.
  1904.  
  1905.      CHPRFS improves the computed solution to a system of linear equations
  1906.      when the coefficient matrix is Hermitian indefinite and packed, and
  1907.      provides error bounds and backward error estimates for the solution.
  1908.  
  1909.  
  1910.  
  1911.                                                                        PPPPaaaaggggeeee 22229999
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  1919.  
  1920.  
  1921.  
  1922.      CHPSV computes the solution to a complex system of linear equations
  1923.         A * X = B, where A is an N-by-N Hermitian matrix stored in packed
  1924.      format and X and B are N-by-NRHS matrices.
  1925.  
  1926.      CHPSVX uses the diagonal pivoting factorization A = U*D*U**H or A =
  1927.      L*D*L**H to compute the solution to a complex system of linear equations
  1928.      A * X = B, where A is an N-by-N Hermitian matrix stored in packed format
  1929.      and X and B are N-by-NRHS matrices.
  1930.  
  1931.      CHPTRD reduces a complex Hermitian matrix A stored in packed form to real
  1932.      symmetric tridiagonal form T by a unitary similarity transformation: Q**H
  1933.      * A * Q = T.
  1934.  
  1935.      CHPTRF computes the factorization of a complex Hermitian packed matrix A
  1936.      using the Bunch-Kaufman diagonal pivoting method:
  1937.  
  1938.         A = U*D*U**H  or  A = L*D*L**H
  1939.  
  1940.      CHPTRI computes the inverse of a complex Hermitian indefinite matrix A in
  1941.      packed storage using the factorization A = U*D*U**H or A = L*D*L**H
  1942.      computed by CHPTRF.
  1943.  
  1944.      CHPTRS solves a system of linear equations A*X = B with a complex
  1945.      Hermitian matrix A stored in packed format using the factorization A =
  1946.      U*D*U**H or A = L*D*L**H computed by CHPTRF.
  1947.  
  1948.      CHSEIN uses inverse iteration to find specified right and/or left
  1949.      eigenvectors of a complex upper Hessenberg matrix H.
  1950.  
  1951.      CHSEQR computes the eigenvalues of a complex upper Hessenberg matrix H,
  1952.      and, optionally, the matrices T and Z from the Schur decomposition H = Z
  1953.      T Z**H, where T is an upper triangular matrix (the Schur form), and Z is
  1954.      the unitary matrix of Schur vectors.
  1955.  
  1956.      CLABRD reduces the first NB rows and columns of a complex general m by n
  1957.      matrix A to upper or lower real bidiagonal form by a unitary
  1958.      transformation Q' * A * P, and returns the matrices X and Y which are
  1959.      needed to apply the transformation to the unreduced part of A.
  1960.  
  1961.      CLACGV conjugates a complex vector of length N.
  1962.  
  1963.      CLACON estimates the 1-norm of a square, complex matrix A.  Reverse
  1964.      communication is used for evaluating matrix-vector products.
  1965.  
  1966.      CLACPY copies all or part of a two-dimensional matrix A to another matrix
  1967.      B.
  1968.  
  1969.      CLACRT applies a plane rotation, where the cos and sin (C and S) are
  1970.      complex and the vectors CX and CY are complex.
  1971.  
  1972.      CLADIV := X / Y, where X and Y are complex.  The computation of X / Y
  1973.      will not overflow on an intermediary step unless the results overflows.
  1974.  
  1975.  
  1976.  
  1977.                                                                        PPPPaaaaggggeeee 33330000
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  1985.  
  1986.  
  1987.  
  1988.      CLAEIN uses inverse iteration to find a right or left eigenvector
  1989.      corresponding to the eigenvalue W of a complex upper Hessenberg matrix H.
  1990.  
  1991.      CLAESY computes the eigendecomposition of a 2x2 symmetric matrix
  1992.         ( ( A, B );( B, C ) ) provided the norm of the matrix of eigenvectors
  1993.      is larger than some threshold value.
  1994.  
  1995.      CLAEV2 computes the eigendecomposition of a 2-by-2 Hermitian matrix
  1996.         [  A         B  ]
  1997.         [  CONJG(B)  C  ].  On return, RT1 is the eigenvalue of larger
  1998.      absolute value, RT2 is the eigenvalue of smaller absolute value, and
  1999.      (CS1,SN1) is the unit right eigenvector for RT1, giving the decomposition
  2000.  
  2001.      CLAGS2 computes 2-by-2 unitary matrices U, V and Q, such that if ( UPPER
  2002.      ) then
  2003.            ( -CONJG(SNU)  CSU )      ( -CONJG(SNV) CSV )
  2004.  
  2005.      CLAGTM performs a matrix-vector product of the form
  2006.  
  2007.  
  2008.      CLAHEF computes a partial factorization of a complex Hermitian matrix A
  2009.      using the Bunch-Kaufman diagonal pivoting method. The partial
  2010.      factorization has the form:
  2011.  
  2012.      CLAHQR is an auxiliary routine called by CHSEQR to update the eigenvalues
  2013.      and Schur decomposition already computed by CHSEQR, by dealing with the
  2014.      Hessenberg submatrix in rows and columns ILO to IHI.
  2015.  
  2016.      CLAHRD reduces the first NB columns of a complex general n-by-(n-k+1)
  2017.      matrix A so that elements below the k-th subdiagonal are zero. The
  2018.      reduction is performed by a unitary similarity transformation Q' * A * Q.
  2019.      The routine returns the matrices V and T which determine Q as a block
  2020.      reflector I - V*T*V', and also the matrix Y = A * V * T.
  2021.  
  2022.      CLAIC1 applies one step of incremental condition estimation in its
  2023.      simplest version:
  2024.  
  2025.      Let x, twonorm(x) = 1, be an approximate singular vector of an j-by-j
  2026.      lower triangular matrix L, such that
  2027.  
  2028.      CLANGB  returns the value of the one norm,  or the Frobenius norm, or the
  2029.      infinity norm,  or the element of  largest absolute value  of an n by n
  2030.      band matrix  A,  with kl sub-diagonals and ku super-diagonals.
  2031.  
  2032.      CLANGE  returns the value of the one norm,  or the Frobenius norm, or the
  2033.      infinity norm,  or the  element of  largest absolute value  of a complex
  2034.      matrix A.
  2035.  
  2036.      CLANGT  returns the value of the one norm,  or the Frobenius norm, or the
  2037.      infinity norm,  or the  element of  largest absolute value  of a complex
  2038.      tridiagonal matrix A.
  2039.  
  2040.  
  2041.  
  2042.  
  2043.                                                                        PPPPaaaaggggeeee 33331111
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  2051.  
  2052.  
  2053.  
  2054.      CLANHB  returns the value of the one norm,  or the Frobenius norm, or the
  2055.      infinity norm,  or the element of  largest absolute value  of an n by n
  2056.      hermitian band matrix A,  with k super-diagonals.
  2057.  
  2058.      CLANHE  returns the value of the one norm,  or the Frobenius norm, or the
  2059.      infinity norm,  or the  element of  largest absolute value  of a complex
  2060.      hermitian matrix A.
  2061.  
  2062.      CLANHP  returns the value of the one norm,  or the Frobenius norm, or the
  2063.      infinity norm,  or the  element of  largest absolute value  of a complex
  2064.      hermitian matrix A,  supplied in packed form.
  2065.  
  2066.      CLANHS  returns the value of the one norm,  or the Frobenius norm, or the
  2067.      infinity norm,  or the  element of  largest absolute value  of a
  2068.      Hessenberg matrix A.
  2069.  
  2070.      CLANHT  returns the value of the one norm,  or the Frobenius norm, or the
  2071.      infinity norm,  or the  element of  largest absolute value  of a complex
  2072.      Hermitian tridiagonal matrix A.
  2073.  
  2074.      CLANSB  returns the value of the one norm,  or the Frobenius norm, or the
  2075.      infinity norm,  or the element of  largest absolute value  of an n by n
  2076.      symmetric band matrix A,  with k super-diagonals.
  2077.  
  2078.      CLANSP  returns the value of the one norm,  or the Frobenius norm, or the
  2079.      infinity norm,  or the  element of  largest absolute value  of a complex
  2080.      symmetric matrix A,  supplied in packed form.
  2081.  
  2082.      CLANSY  returns the value of the one norm,  or the Frobenius norm, or the
  2083.      infinity norm,  or the  element of  largest absolute value  of a complex
  2084.      symmetric matrix A.
  2085.  
  2086.      CLANTB  returns the value of the one norm,  or the Frobenius norm, or the
  2087.      infinity norm,  or the element of  largest absolute value  of an n by n
  2088.      triangular band matrix A,  with ( k + 1 ) diagonals.
  2089.  
  2090.      CLANTP  returns the value of the one norm,  or the Frobenius norm, or the
  2091.      infinity norm,  or the  element of  largest absolute value  of a
  2092.      triangular matrix A, supplied in packed form.
  2093.  
  2094.      CLANTR  returns the value of the one norm,  or the Frobenius norm, or the
  2095.      infinity norm,  or the  element of  largest absolute value  of a
  2096.      trapezoidal or triangular matrix A.
  2097.  
  2098.      Given two column vectors X and Y, let
  2099.  
  2100.      The subroutine first computes the QR factorization of A = Q*R, and then
  2101.      computes the SVD of the 2-by-2 upper triangular matrix R.  The smaller
  2102.      singular value of R is returned in SSMIN, which is used as the
  2103.      measurement of the linear dependency of the vectors X and Y.
  2104.  
  2105.      CLAPMT rearranges the columns of the M by N matrix X as specified by the
  2106.  
  2107.  
  2108.  
  2109.                                                                        PPPPaaaaggggeeee 33332222
  2110.  
  2111.  
  2112.  
  2113.  
  2114.  
  2115.  
  2116. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  2117.  
  2118.  
  2119.  
  2120.      permutation K(1),K(2),...,K(N) of the integers 1,...,N.  If FORWRD =
  2121.      .TRUE.,  forward permutation:
  2122.  
  2123.      CLAQGB equilibrates a general M by N band matrix A with KL subdiagonals
  2124.      and KU superdiagonals using the row and scaling factors in the vectors R
  2125.      and C.
  2126.  
  2127.      CLAQGE equilibrates a general M by N matrix A using the row and scaling
  2128.      factors in the vectors R and C.
  2129.  
  2130.      CLAQSB equilibrates a symmetric band matrix A using the scaling factors
  2131.      in the vector S.
  2132.  
  2133.      CLAQSP equilibrates a symmetric matrix A using the scaling factors in the
  2134.      vector S.
  2135.  
  2136.      CLAQSY equilibrates a symmetric matrix A using the scaling factors in the
  2137.      vector S.
  2138.  
  2139.      CLAR2V applies a vector of complex plane rotations with real cosines from
  2140.      both sides to a sequence of 2-by-2 complex Hermitian matrices, defined by
  2141.      the elements of the vectors x, y and z. For i = 1,2,...,n
  2142.  
  2143.         (       x(i)  z(i) ) :=
  2144.  
  2145.      CLARF applies a complex elementary reflector H to a complex M-by-N matrix
  2146.      C, from either the left or the right. H is represented in the form
  2147.  
  2148.      CLARFB applies a complex block reflector H or its transpose H' to a
  2149.      complex M-by-N matrix C, from either the left or the right.
  2150.  
  2151.      CLARFG generates a complex elementary reflector H of order n, such that
  2152.                 (   x   )   (   0  )
  2153.  
  2154.      CLARFT forms the triangular factor T of a complex block reflector H of
  2155.      order n, which is defined as a product of k elementary reflectors.
  2156.  
  2157.      CLARFX applies a complex elementary reflector H to a complex m by n
  2158.      matrix C, from either the left or the right. H is represented in the form
  2159.  
  2160.      CLARGV generates a vector of complex plane rotations with real cosines,
  2161.      determined by elements of the complex vectors x and y.  For i = 1,2,...,n
  2162.  
  2163.      CLARNV returns a vector of n random complex numbers from a uniform or
  2164.      normal distribution.
  2165.  
  2166.      CLARTG generates a plane rotation so that
  2167.         [ -SN  CS  ]     [ G ]     [ 0 ]
  2168.  
  2169.      CLARTV applies a vector of complex plane rotations with real cosines to
  2170.      elements of the complex vectors x and y. For i = 1,2,...,n
  2171.  
  2172.  
  2173.  
  2174.  
  2175.                                                                        PPPPaaaaggggeeee 33333333
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  2183.  
  2184.  
  2185.  
  2186.         ( x(i) ) := (        c(i)   s(i) ) ( x(i) )
  2187.  
  2188.      CLASCL multiplies the M by N complex matrix A by the real scalar
  2189.      CTO/CFROM.  This is done without over/underflow as long as the final
  2190.      result CTO*A(I,J)/CFROM does not over/underflow. TYPE specifies that A
  2191.      may be full, upper triangular, lower triangular, upper Hessenberg, or
  2192.      banded.
  2193.  
  2194.      CLASET initializes a 2-D array A to BETA on the diagonal and ALPHA on the
  2195.      offdiagonals.
  2196.  
  2197.      CLASR   performs the transformation consisting of a sequence of plane
  2198.      rotations determined by the parameters PIVOT and DIRECT as follows ( z =
  2199.      m when SIDE = 'L' or 'l' and z = n when SIDE = 'R' or 'r' ):
  2200.  
  2201.      CLASSQ returns the values scl and ssq such that
  2202.  
  2203.      where x( i ) = abs( X( 1 + ( i - 1 )*INCX ) ). The value of sumsq is
  2204.      assumed to be at least unity and the value of ssq will then satisfy
  2205.  
  2206.         1.0 .le. ssq .le. ( sumsq + 2*n ).
  2207.  
  2208.      CLASWP performs a series of row interchanges on the matrix A.  One row
  2209.      interchange is initiated for each of rows K1 through K2 of A.
  2210.  
  2211.      CLASYF computes a partial factorization of a complex symmetric matrix A
  2212.      using the Bunch-Kaufman diagonal pivoting method. The partial
  2213.      factorization has the form:
  2214.  
  2215.      CLATBS solves one of the triangular systems
  2216.  
  2217.      with scaling to prevent overflow, where A is an upper or lower triangular
  2218.      band matrix.  Here A' denotes the transpose of A, x and b are n-element
  2219.      vectors, and s is a scaling factor, usually less than or equal to 1,
  2220.      chosen so that the components of x will be less than the overflow
  2221.      threshold.  If the unscaled problem will not cause overflow, the Level 2
  2222.      BLAS routine CTBSV is called.  If the matrix A is singular (A(j,j) = 0
  2223.      for some j), then s is set to 0 and a non-trivial solution to A*x = 0 is
  2224.      returned.
  2225.  
  2226.      CLATPS solves one of the triangular systems
  2227.  
  2228.      with scaling to prevent overflow, where A is an upper or lower triangular
  2229.      matrix stored in packed form.  Here A**T denotes the transpose of A, A**H
  2230.      denotes the conjugate transpose of A, x and b are n-element vectors, and
  2231.      s is a scaling factor, usually less than or equal to 1, chosen so that
  2232.      the components of x will be less than the overflow threshold.  If the
  2233.      unscaled problem will not cause overflow, the Level 2 BLAS routine CTPSV
  2234.      is called. If the matrix A is singular (A(j,j) = 0 for some j), then s is
  2235.      set to 0 and a non-trivial solution to A*x = 0 is returned.
  2236.  
  2237.      CLATRD reduces NB rows and columns of a complex Hermitian matrix A to
  2238.  
  2239.  
  2240.  
  2241.                                                                        PPPPaaaaggggeeee 33334444
  2242.  
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  2249.  
  2250.  
  2251.  
  2252.      Hermitian tridiagonal form by a unitary similarity transformation Q' * A
  2253.      * Q, and returns the matrices V and W which are needed to apply the
  2254.      transformation to the unreduced part of A.
  2255.  
  2256.      CLATRS solves one of the triangular systems
  2257.  
  2258.      with scaling to prevent overflow.  Here A is an upper or lower triangular
  2259.      matrix, A**T denotes the transpose of A, A**H denotes the conjugate
  2260.      transpose of A, x and b are n-element vectors, and s is a scaling factor,
  2261.      usually less than or equal to 1, chosen so that the components of x will
  2262.      be less than the overflow threshold.  If the unscaled problem will not
  2263.      cause overflow, the Level 2 BLAS routine CTRSV is called. If the matrix A
  2264.      is singular (A(j,j) = 0 for some j), then s is set to 0 and a non-trivial
  2265.      solution to A*x = 0 is returned.
  2266.  
  2267.      CLATZM applies a Householder matrix generated by CTZRQF to a matrix.
  2268.  
  2269.      CLAUU2 computes the product U * U' or L' * L, where the triangular factor
  2270.      U or L is stored in the upper or lower triangular part of the array A.
  2271.  
  2272.      CLAUUM computes the product U * U' or L' * L, where the triangular factor
  2273.      U or L is stored in the upper or lower triangular part of the array A.
  2274.  
  2275.      CLAZRO initializes a 2-D array A to BETA on the diagonal and ALPHA on the
  2276.      offdiagonals.
  2277.  
  2278.      CPBCON estimates the reciprocal of the condition number (in the 1-norm)
  2279.      of a complex Hermitian positive definite band matrix using the Cholesky
  2280.      factorization A = U**H*U or A = L*L**H computed by CPBTRF.
  2281.  
  2282.      CPBEQU computes row and column scalings intended to equilibrate a
  2283.      Hermitian positive definite band matrix A and reduce its condition number
  2284.      (with respect to the two-norm).  S contains the scale factors, S(i) =
  2285.      1/sqrt(A(i,i)), chosen so that the scaled matrix B with elements B(i,j) =
  2286.      S(i)*A(i,j)*S(j) has ones on the diagonal.  This choice of S puts the
  2287.      condition number of B within a factor N of the smallest possible
  2288.      condition number over all possible diagonal scalings.
  2289.  
  2290.      CPBRFS improves the computed solution to a system of linear equations
  2291.      when the coefficient matrix is Hermitian positive definite and banded,
  2292.      and provides error bounds and backward error estimates for the solution.
  2293.  
  2294.      CPBSV computes the solution to a complex system of linear equations
  2295.         A * X = B, where A is an N-by-N Hermitian positive definite band
  2296.      matrix and X and B are N-by-NRHS matrices.
  2297.  
  2298.      CPBSVX uses the Cholesky factorization A = U**H*U or A = L*L**H to
  2299.      compute the solution to a complex system of linear equations
  2300.         A * X = B, where A is an N-by-N Hermitian positive definite band
  2301.      matrix and X and B are N-by-NRHS matrices.
  2302.  
  2303.      CPBTF2 computes the Cholesky factorization of a complex Hermitian
  2304.  
  2305.  
  2306.  
  2307.                                                                        PPPPaaaaggggeeee 33335555
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  2315.  
  2316.  
  2317.  
  2318.      positive definite band matrix A.
  2319.  
  2320.      CPBTRF computes the Cholesky factorization of a complex Hermitian
  2321.      positive definite band matrix A.
  2322.  
  2323.      CPBTRS solves a system of linear equations A*X = B with a Hermitian
  2324.      positive definite band matrix A using the Cholesky factorization A =
  2325.      U**H*U or A = L*L**H computed by CPBTRF.
  2326.  
  2327.      CPOCON estimates the reciprocal of the condition number (in the 1-norm)
  2328.      of a complex Hermitian positive definite matrix using the Cholesky
  2329.      factorization A = U**H*U or A = L*L**H computed by CPOTRF.
  2330.  
  2331.      CPOEQU computes row and column scalings intended to equilibrate a
  2332.      Hermitian positive definite matrix A and reduce its condition number
  2333.      (with respect to the two-norm).  S contains the scale factors, S(i) =
  2334.      1/sqrt(A(i,i)), chosen so that the scaled matrix B with elements B(i,j) =
  2335.      S(i)*A(i,j)*S(j) has ones on the diagonal.  This choice of S puts the
  2336.      condition number of B within a factor N of the smallest possible
  2337.      condition number over all possible diagonal scalings.
  2338.  
  2339.      CPORFS improves the computed solution to a system of linear equations
  2340.      when the coefficient matrix is Hermitian positive definite, and provides
  2341.      error bounds and backward error estimates for the solution.
  2342.  
  2343.      CPOSV computes the solution to a complex system of linear equations
  2344.         A * X = B, where A is an N-by-N Hermitian positive definite matrix and
  2345.      X and B are N-by-NRHS matrices.
  2346.  
  2347.      CPOSVX uses the Cholesky factorization A = U**H*U or A = L*L**H to
  2348.      compute the solution to a complex system of linear equations
  2349.         A * X = B, where A is an N-by-N Hermitian positive definite matrix and
  2350.      X and B are N-by-NRHS matrices.
  2351.  
  2352.      CPOTF2 computes the Cholesky factorization of a complex Hermitian
  2353.      positive definite matrix A.
  2354.  
  2355.      CPOTRF computes the Cholesky factorization of a complex Hermitian
  2356.      positive definite matrix A.
  2357.  
  2358.      CPOTRI computes the inverse of a complex Hermitian positive definite
  2359.      matrix A using the Cholesky factorization A = U**H*U or A = L*L**H
  2360.      computed by CPOTRF.
  2361.  
  2362.      CPOTRS solves a system of linear equations A*X = B with a Hermitian
  2363.      positive definite matrix A using the Cholesky factorization A = U**H*U or
  2364.      A = L*L**H computed by CPOTRF.
  2365.  
  2366.      CPPCON estimates the reciprocal of the condition number (in the 1-norm)
  2367.      of a complex Hermitian positive definite packed matrix using the Cholesky
  2368.      factorization A = U**H*U or A = L*L**H computed by CPPTRF.
  2369.  
  2370.  
  2371.  
  2372.  
  2373.                                                                        PPPPaaaaggggeeee 33336666
  2374.  
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  2381.  
  2382.  
  2383.  
  2384.      CPPEQU computes row and column scalings intended to equilibrate a
  2385.      Hermitian positive definite matrix A in packed storage and reduce its
  2386.      condition number (with respect to the two-norm).  S contains the scale
  2387.      factors, S(i)=1/sqrt(A(i,i)), chosen so that the scaled matrix B with
  2388.      elements B(i,j)=S(i)*A(i,j)*S(j) has ones on the diagonal.  This choice
  2389.      of S puts the condition number of B within a factor N of the smallest
  2390.      possible condition number over all possible diagonal scalings.
  2391.  
  2392.      CPPRFS improves the computed solution to a system of linear equations
  2393.      when the coefficient matrix is Hermitian positive definite and packed,
  2394.      and provides error bounds and backward error estimates for the solution.
  2395.  
  2396.      CPPSV computes the solution to a complex system of linear equations
  2397.         A * X = B, where A is an N-by-N Hermitian positive definite matrix
  2398.      stored in packed format and X and B are N-by-NRHS matrices.
  2399.  
  2400.      CPPSVX uses the Cholesky factorization A = U**H*U or A = L*L**H to
  2401.      compute the solution to a complex system of linear equations
  2402.         A * X = B, where A is an N-by-N Hermitian positive definite matrix
  2403.      stored in packed format and X and B are N-by-NRHS matrices.
  2404.  
  2405.      CPPTRF computes the Cholesky factorization of a complex Hermitian
  2406.      positive definite matrix stored in packed format.
  2407.  
  2408.      CPPTRI computes the inverse of a complex Hermitian positive definite
  2409.      matrix A using the Cholesky factorization A = U**H*U or A = L*L**H
  2410.      computed by CPPTRF.
  2411.  
  2412.      CPPTRS solves a system of linear equations A*X = B with a Hermitian
  2413.      positive definite matrix A in packed storage using the Cholesky
  2414.      factorization A = U**H*U or A = L*L**H computed by CPPTRF.
  2415.  
  2416.      CPTCON computes the reciprocal of the condition number (in the 1-norm) of
  2417.      a complex Hermitian positive definite tridiagonal matrix using the
  2418.      factorization A = L*D*L**T or A = U**T*D*U computed by CPTTRF.
  2419.  
  2420.      CPTEQR computes all eigenvalues and, optionally, eigenvectors of a
  2421.      symmetric positive definite tridiagonal matrix by first factoring the
  2422.      matrix using SPTTRF and then calling CBDSQR to compute the singular
  2423.      values of the bidiagonal factor.
  2424.  
  2425.      CPTRFS improves the computed solution to a system of linear equations
  2426.      when the coefficient matrix is Hermitian positive definite and
  2427.      tridiagonal, and provides error bounds and backward error estimates for
  2428.      the solution.
  2429.  
  2430.      CPTSV computes the solution to a complex system of linear equations A*X =
  2431.      B, where A is an N-by-N Hermitian positive definite tridiagonal matrix,
  2432.      and X and B are N-by-NRHS matrices.
  2433.  
  2434.      CPTSVX uses the factorization A = L*D*L**H to compute the solution to a
  2435.      complex system of linear equations A*X = B, where A is an N-by-N
  2436.  
  2437.  
  2438.  
  2439.                                                                        PPPPaaaaggggeeee 33337777
  2440.  
  2441.  
  2442.  
  2443.  
  2444.  
  2445.  
  2446. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  2447.  
  2448.  
  2449.  
  2450.      Hermitian positive definite tridiagonal matrix and X and B are N-by-NRHS
  2451.      matrices.
  2452.  
  2453.      CPTTRF computes the factorization of a complex Hermitian positive
  2454.      definite tridiagonal matrix A.
  2455.  
  2456.      CPTTRS solves a system of linear equations A * X = B with a Hermitian
  2457.      positive definite tridiagonal matrix A using the factorization A =
  2458.      U**H*D*U or A = L*D*L**H computed by CPTTRF.
  2459.  
  2460.      CROT   applies a plane rotation, where the cos (C) is real and the sin
  2461.      (S) is complex, and the vectors CX and CY are complex.
  2462.  
  2463.      CSPCON estimates the reciprocal of the condition number (in the 1-norm)
  2464.      of a complex symmetric packed matrix A using the factorization A =
  2465.      U*D*U**T or A = L*D*L**T computed by CSPTRF.
  2466.  
  2467.      CSPMV  performs the matrix-vector operation
  2468.  
  2469.      where alpha and beta are scalars, x and y are n element vectors and A is
  2470.      an n by n symmetric matrix, supplied in packed form.
  2471.  
  2472.      CSPR    performs the symmetric rank 1 operation
  2473.  
  2474.      where alpha is a complex scalar, x is an n element vector and A is an n
  2475.      by n symmetric matrix, supplied in packed form.
  2476.  
  2477.      CSPRFS improves the computed solution to a system of linear equations
  2478.      when the coefficient matrix is symmetric indefinite and packed, and
  2479.      provides error bounds and backward error estimates for the solution.
  2480.  
  2481.      CSPSV computes the solution to a complex system of linear equations
  2482.         A * X = B, where A is an N-by-N symmetric matrix stored in packed
  2483.      format and X and B are N-by-NRHS matrices.
  2484.  
  2485.      CSPSVX uses the diagonal pivoting factorization A = U*D*U**T or A =
  2486.      L*D*L**T to compute the solution to a complex system of linear equations
  2487.      A * X = B, where A is an N-by-N symmetric matrix stored in packed format
  2488.      and X and B are N-by-NRHS matrices.
  2489.  
  2490.      CSPTRF computes the factorization of a complex symmetric matrix A stored
  2491.      in packed format using the Bunch-Kaufman diagonal pivoting method:
  2492.  
  2493.         A = U*D*U**T  or  A = L*D*L**T
  2494.  
  2495.      CSPTRI computes the inverse of a complex symmetric indefinite matrix A in
  2496.      packed storage using the factorization A = U*D*U**T or A = L*D*L**T
  2497.      computed by CSPTRF.
  2498.  
  2499.      CSPTRS solves a system of linear equations A*X = B with a complex
  2500.      symmetric matrix A stored in packed format using the factorization A =
  2501.      U*D*U**T or A = L*D*L**T computed by CSPTRF.
  2502.  
  2503.  
  2504.  
  2505.                                                                        PPPPaaaaggggeeee 33338888
  2506.  
  2507.  
  2508.  
  2509.  
  2510.  
  2511.  
  2512. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  2513.  
  2514.  
  2515.  
  2516.      CSRSCL multiplies an n-element complex vector x by the real scalar 1/a.
  2517.      This is done without overflow or underflow as long as the final result
  2518.      x/a does not overflow or underflow.
  2519.  
  2520.      CSTEIN computes the eigenvectors of a real symmetric tridiagonal matrix T
  2521.      corresponding to specified eigenvalues, using inverse iteration.
  2522.  
  2523.      CSTEQR computes all eigenvalues and, optionally, eigenvectors of a
  2524.      symmetric tridiagonal matrix using the implicit QL or QR method.  The
  2525.      eigenvectors of a full or band complex Hermitian matrix can also be found
  2526.      if CSYTRD or CSPTRD or CSBTRD has been used to reduce this matrix to
  2527.      tridiagonal form.
  2528.  
  2529.      CSYCON estimates the reciprocal of the condition number (in the 1-norm)
  2530.      of a complex symmetric matrix A using the factorization A = U*D*U**T or A
  2531.      = L*D*L**T computed by CSYTRF.
  2532.  
  2533.      CSYMV  performs the matrix-vector  operation
  2534.  
  2535.      where alpha and beta are scalars, x and y are n element vectors and A is
  2536.      an n by n symmetric matrix.
  2537.  
  2538.      CSYR   performs the symmetric rank 1 operation
  2539.  
  2540.      where alpha is a complex scalar, x is an n element vector and A is an n
  2541.      by n symmetric matrix.
  2542.  
  2543.      CSYRFS improves the computed solution to a system of linear equations
  2544.      when the coefficient matrix is symmetric indefinite, and provides error
  2545.      bounds and backward error estimates for the solution.
  2546.  
  2547.      CSYSV computes the solution to a complex system of linear equations
  2548.         A * X = B, where A is an N-by-N symmetric matrix and X and B are N-
  2549.      by-NRHS matrices.
  2550.  
  2551.      CSYSVX uses the diagonal pivoting factorization to compute the solution
  2552.      to a complex system of linear equations A * X = B, where A is an N-by-N
  2553.      symmetric matrix and X and B are N-by-NRHS matrices.
  2554.  
  2555.      CSYTF2 computes the factorization of a complex symmetric matrix A using
  2556.      the Bunch-Kaufman diagonal pivoting method:
  2557.  
  2558.         A = U*D*U'  or  A = L*D*L'
  2559.  
  2560.      CSYTRF computes the factorization of a complex symmetric matrix A using
  2561.      the Bunch-Kaufman diagonal pivoting method.  The form of the
  2562.      factorization is
  2563.  
  2564.      CSYTRI computes the inverse of a complex symmetric indefinite matrix A
  2565.      using the factorization A = U*D*U**T or A = L*D*L**T computed by CSYTRF.
  2566.  
  2567.      CSYTRS solves a system of linear equations A*X = B with a complex
  2568.  
  2569.  
  2570.  
  2571.                                                                        PPPPaaaaggggeeee 33339999
  2572.  
  2573.  
  2574.  
  2575.  
  2576.  
  2577.  
  2578. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  2579.  
  2580.  
  2581.  
  2582.      symmetric matrix A using the factorization A = U*D*U**T or A = L*D*L**T
  2583.      computed by CSYTRF.
  2584.  
  2585.      CTBCON estimates the reciprocal of the condition number of a triangular
  2586.      band matrix A, in either the 1-norm or the infinity-norm.
  2587.  
  2588.      CTBRFS provides error bounds and backward error estimates for the
  2589.      solution to a system of linear equations with a triangular band
  2590.      coefficient matrix.
  2591.  
  2592.      CTBTRS solves a triangular system of the form
  2593.  
  2594.      where A is a triangular band matrix of order N, and B is an N-by-NRHS
  2595.      matrix.  A check is made to verify that A is nonsingular.
  2596.  
  2597.      CTGEVC computes selected left and/or right generalized eigenvectors of a
  2598.      pair of complex upper triangular matrices (A,B).  The j-th generalized
  2599.      left and right eigenvectors are  y  and  x, resp., such that:
  2600.  
  2601.      CTGSJA computes the generalized singular value decomposition (GSVD) of
  2602.      two complex upper triangular (or trapezoidal) matrices A and B.
  2603.  
  2604.      CTPCON estimates the reciprocal of the condition number of a packed
  2605.      triangular matrix A, in either the 1-norm or the infinity-norm.
  2606.  
  2607.      CTPRFS provides error bounds and backward error estimates for the
  2608.      solution to a system of linear equations with a triangular packed
  2609.      coefficient matrix.
  2610.  
  2611.      CTPTRI computes the inverse of a complex upper or lower triangular matrix
  2612.      A stored in packed format.
  2613.  
  2614.      CTPTRS solves a triangular system of the form
  2615.  
  2616.      where A is a triangular matrix of order N stored in packed format, and B
  2617.      is an N-by-NRHS matrix.  A check is made to verify that A is nonsingular.
  2618.  
  2619.      CTRCON estimates the reciprocal of the condition number of a triangular
  2620.      matrix A, in either the 1-norm or the infinity-norm.
  2621.  
  2622.      CTREVC computes all or some right and/or left eigenvectors of a complex
  2623.      upper triangular matrix T.
  2624.  
  2625.      CTREXC reorders the Schur factorization of a complex matrix A = Q*T*Q**H,
  2626.      so that the diagonal element of T with row index IFST is moved to row
  2627.      ILST.
  2628.  
  2629.      CTRRFS provides error bounds and backward error estimates for the
  2630.      solution to a system of linear equations with a triangular coefficient
  2631.      matrix.
  2632.  
  2633.      CTRSEN reorders the Schur factorization of a complex matrix A = Q*T*Q**H,
  2634.  
  2635.  
  2636.  
  2637.                                                                        PPPPaaaaggggeeee 44440000
  2638.  
  2639.  
  2640.  
  2641.  
  2642.  
  2643.  
  2644. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  2645.  
  2646.  
  2647.  
  2648.      so that a selected cluster of eigenvalues appears in the leading
  2649.      positions on the diagonal of the upper triangular matrix T, and the
  2650.      leading columns of Q form an orthonormal basis of the corresponding right
  2651.      invariant subspace.
  2652.  
  2653.      CTRSNA estimates reciprocal condition numbers for specified eigenvalues
  2654.      and/or right eigenvectors of a complex upper triangular matrix T (or of
  2655.      any matrix Q*T*Q**H with Q unitary).
  2656.  
  2657.      CTRSYL solves the complex Sylvester matrix equation:
  2658.  
  2659.         op(A)*X + X*op(B) = scale*C or
  2660.  
  2661.      CTRTI2 computes the inverse of a complex upper or lower triangular
  2662.      matrix.
  2663.  
  2664.      CTRTRI computes the inverse of a complex upper or lower triangular matrix
  2665.      A.
  2666.  
  2667.      CTRTRS solves a triangular system of the form
  2668.  
  2669.      where A is a triangular matrix of order N, and B is an N-by-NRHS matrix.
  2670.      A check is made to verify that A is nonsingular.
  2671.  
  2672.      CTZRQF reduces the M-by-N ( M<=N ) complex upper trapezoidal matrix A to
  2673.      upper triangular form by means of unitary transformations.
  2674.  
  2675.      CUNG2L generates an m by n complex matrix Q with orthonormal columns,
  2676.      which is defined as the last n columns of a product of k elementary
  2677.      reflectors of order m
  2678.  
  2679.      CUNG2R generates an m by n complex matrix Q with orthonormal columns,
  2680.      which is defined as the first n columns of a product of k elementary
  2681.      reflectors of order m
  2682.  
  2683.      CUNGBR generates one of the matrices Q or P**H determined by CGEBRD when
  2684.      reducing a complex matrix A to bidiagonal form:  A = Q * B * P**H.
  2685.  
  2686.      CUNGHR generates a complex unitary matrix Q which is defined as the
  2687.      product of IHI-ILO elementary reflectors of order N, as returned by
  2688.      CGEHRD:
  2689.  
  2690.      Q = H(ilo) H(ilo+1) . . . H(ihi-1).
  2691.  
  2692.      CUNGL2 generates an m-by-n complex matrix Q with orthonormal rows, which
  2693.      is defined as the first m rows of a product of k elementary reflectors of
  2694.      order n
  2695.  
  2696.      CUNGLQ generates an M-by-N complex matrix Q with orthonormal rows, which
  2697.      is defined as the first M rows of a product of K elementary reflectors of
  2698.      order N
  2699.  
  2700.  
  2701.  
  2702.  
  2703.                                                                        PPPPaaaaggggeeee 44441111
  2704.  
  2705.  
  2706.  
  2707.  
  2708.  
  2709.  
  2710. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  2711.  
  2712.  
  2713.  
  2714.      CUNGQL generates an M-by-N complex matrix Q with orthonormal columns,
  2715.      which is defined as the last N columns of a product of K elementary
  2716.      reflectors of order M
  2717.  
  2718.      CUNGQR generates an M-by-N complex matrix Q with orthonormal columns,
  2719.      which is defined as the first N columns of a product of K elementary
  2720.      reflectors of order M
  2721.  
  2722.      CUNGR2 generates an m by n complex matrix Q with orthonormal rows, which
  2723.      is defined as the last m rows of a product of k elementary reflectors of
  2724.      order n
  2725.  
  2726.      CUNGRQ generates an M-by-N complex matrix Q with orthonormal rows, which
  2727.      is defined as the last M rows of a product of K elementary reflectors of
  2728.      order N
  2729.  
  2730.      CUNGTR generates a complex unitary matrix Q which is defined as the
  2731.      product of n-1 elementary reflectors of order N, as returned by CHETRD:
  2732.  
  2733.      if UPLO = 'U', Q = H(n-1) . . . H(2) H(1),
  2734.  
  2735.      CUNM2L overwrites the general complex m-by-n matrix C with
  2736.  
  2737.      where Q is a complex unitary matrix defined as the product of k
  2738.      elementary reflectors
  2739.  
  2740.      CUNM2R overwrites the general complex m-by-n matrix C with
  2741.  
  2742.      where Q is a complex unitary matrix defined as the product of k
  2743.      elementary reflectors
  2744.  
  2745.      If VECT = 'Q', CUNMBR overwrites the general complex M-by-N matrix C with
  2746.                      SIDE = 'L'     SIDE = 'R' TRANS = 'N':      Q * C
  2747.      C * Q TRANS = 'C':      Q**H * C       C * Q**H
  2748.  
  2749.      CUNMHR overwrites the general complex M-by-N matrix C with TRANS = 'C':
  2750.      Q**H * C       C * Q**H
  2751.  
  2752.      CUNML2 overwrites the general complex m-by-n matrix C with
  2753.  
  2754.      where Q is a complex unitary matrix defined as the product of k
  2755.      elementary reflectors
  2756.  
  2757.      CUNMLQ overwrites the general complex M-by-N matrix C with TRANS = 'C':
  2758.      Q**H * C       C * Q**H
  2759.  
  2760.      CUNMQL overwrites the general complex M-by-N matrix C with TRANS = 'C':
  2761.      Q**H * C       C * Q**H
  2762.  
  2763.      CUNMQR overwrites the general complex M-by-N matrix C with TRANS = 'C':
  2764.      Q**H * C       C * Q**H
  2765.  
  2766.  
  2767.  
  2768.  
  2769.                                                                        PPPPaaaaggggeeee 44442222
  2770.  
  2771.  
  2772.  
  2773.  
  2774.  
  2775.  
  2776. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  2777.  
  2778.  
  2779.  
  2780.      CUNMR2 overwrites the general complex m-by-n matrix C with
  2781.  
  2782.      where Q is a complex unitary matrix defined as the product of k
  2783.      elementary reflectors
  2784.  
  2785.      CUNMRQ overwrites the general complex M-by-N matrix C with TRANS = 'C':
  2786.      Q**H * C       C * Q**H
  2787.  
  2788.      CUNMTR overwrites the general complex M-by-N matrix C with TRANS = 'C':
  2789.      Q**H * C       C * Q**H
  2790.  
  2791.      CUPGTR generates a complex unitary matrix Q which is defined as the
  2792.      product of n-1 elementary reflectors of order n, as returned by CHPTRD
  2793.      using packed storage:
  2794.  
  2795.      if UPLO = 'U', Q = H(n-1) . . . H(2) H(1),
  2796.  
  2797.      CUPMTR overwrites the general complex M-by-N matrix C with TRANS = 'C':
  2798.      Q**H * C       C * Q**H
  2799.  
  2800.      DBDSQR computes the singular value decomposition (SVD) of a real N-by-N
  2801.      (upper or lower) bidiagonal matrix B:  B = Q * S * P' (P' denotes the
  2802.      transpose of P), where S is a diagonal matrix with non-negative diagonal
  2803.      elements (the singular values of B), and Q and P are orthogonal matrices.
  2804.  
  2805.      DGBCON estimates the reciprocal of the condition number of a real general
  2806.      band matrix A, in either the 1-norm or the infinity-norm, using the LU
  2807.      factorization computed by DGBTRF.
  2808.  
  2809.      DGBEQU computes row and column scalings intended to equilibrate an M by N
  2810.      band matrix A and reduce its condition number.  R returns the row scale
  2811.      factors and C the column scale factors, chosen to try to make the largest
  2812.      element in each row and column of the matrix B with elements
  2813.      B(i,j)=R(i)*A(i,j)*C(j) have absolute value 1.
  2814.  
  2815.      DGBRFS improves the computed solution to a system of linear equations
  2816.      when the coefficient matrix is banded, and provides error bounds and
  2817.      backward error estimates for the solution.
  2818.  
  2819.      DGBSV computes the solution to a real system of linear equations A * X =
  2820.      B, where A is a band matrix of order N with KL subdiagonals and KU
  2821.      superdiagonals, and X and B are N-by-NRHS matrices.
  2822.  
  2823.      DGBSVX uses the LU factorization to compute the solution to a real system
  2824.      of linear equations A * X = B, A**T * X = B, or A**H * X = B, where A is
  2825.      a band matrix of order N with KL subdiagonals and KU superdiagonals, and
  2826.      X and B are N-by-NRHS matrices.
  2827.  
  2828.      DGBTF2 computes an LU factorization of a real m-by-n band matrix A using
  2829.      partial pivoting with row interchanges.
  2830.  
  2831.      DGBTRF computes an LU factorization of a real m-by-n band matrix A using
  2832.  
  2833.  
  2834.  
  2835.                                                                        PPPPaaaaggggeeee 44443333
  2836.  
  2837.  
  2838.  
  2839.  
  2840.  
  2841.  
  2842. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  2843.  
  2844.  
  2845.  
  2846.      partial pivoting with row interchanges.
  2847.  
  2848.      DGBTRS solves a system of linear equations
  2849.         A * X = B  or  A' * X = B with a general band matrix A using the LU
  2850.      factorization computed by DGBTRF.
  2851.  
  2852.      DGEBAK forms the right or left eigenvectors of a real general matrix by
  2853.      backward transformation on the computed eigenvectors of the balanced
  2854.      matrix output by DGEBAL.
  2855.  
  2856.      DGEBAL balances a general real matrix A.  This involves, first, permuting
  2857.      A by a similarity transformation to isolate eigenvalues in the first 1 to
  2858.      ILO-1 and last IHI+1 to N elements on the diagonal; and second, applying
  2859.      a diagonal similarity transformation to rows and columns ILO to IHI to
  2860.      make the rows and columns as close in norm as possible.  Both steps are
  2861.      optional.
  2862.  
  2863.      DGEBD2 reduces a real general m by n matrix A to upper or lower
  2864.      bidiagonal form B by an orthogonal transformation: Q' * A * P = B.
  2865.  
  2866.      DGEBRD reduces a general real M-by-N matrix A to upper or lower
  2867.      bidiagonal form B by an orthogonal transformation: Q**T * A * P = B.
  2868.  
  2869.      DGECON estimates the reciprocal of the condition number of a general real
  2870.      matrix A, in either the 1-norm or the infinity-norm, using the LU
  2871.      factorization computed by DGETRF.
  2872.  
  2873.      DGEEQU computes row and column scalings intended to equilibrate an M-by-N
  2874.      matrix A and reduce its condition number.  R returns the row scale
  2875.      factors and C the column scale factors, chosen to try to make the largest
  2876.      entry in each row and column of the matrix B with elements
  2877.      B(i,j)=R(i)*A(i,j)*C(j) have absolute value 1.
  2878.  
  2879.      DGEES computes for an N-by-N real nonsymmetric matrix A, the eigenvalues,
  2880.      the real Schur form T, and, optionally, the matrix of Schur vectors Z.
  2881.      This gives the Schur factorization A = Z*T*(Z**T).
  2882.  
  2883.      DGEESX computes for an N-by-N real nonsymmetric matrix A, the
  2884.      eigenvalues, the real Schur form T, and, optionally, the matrix of Schur
  2885.      vectors Z.  This gives the Schur factorization A = Z*T*(Z**T).
  2886.  
  2887.      DGEEV computes for an N-by-N real nonsymmetric matrix A, the eigenvalues
  2888.      and, optionally, the left and/or right eigenvectors.
  2889.  
  2890.      DGEEVX computes for an N-by-N real nonsymmetric matrix A, the eigenvalues
  2891.      and, optionally, the left and/or right eigenvectors.
  2892.  
  2893.      For a pair of N-by-N real nonsymmetric matrices A, B:
  2894.  
  2895.         compute the generalized eigenvalues (alphar +/- alphai*i, beta)
  2896.         compute the real Schur form (A,B)
  2897.  
  2898.  
  2899.  
  2900.  
  2901.                                                                        PPPPaaaaggggeeee 44444444
  2902.  
  2903.  
  2904.  
  2905.  
  2906.  
  2907.  
  2908. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  2909.  
  2910.  
  2911.  
  2912.      For a pair of N-by-N real nonsymmetric matrices A, B:
  2913.  
  2914.         compute the generalized eigenvalues (alphar +/- alphai*i, beta)
  2915.         compute the left and/or right generalized eigenvectors
  2916.                 (VL and VR)
  2917.  
  2918.      DGEHD2 reduces a real general matrix A to upper Hessenberg form H by an
  2919.      orthogonal similarity transformation:  Q' * A * Q = H .
  2920.  
  2921.      DGEHRD reduces a real general matrix A to upper Hessenberg form H by an
  2922.      orthogonal similarity transformation:  Q' * A * Q = H .
  2923.  
  2924.      DGELQ2 computes an LQ factorization of a real m by n matrix A:  A = L *
  2925.      Q.
  2926.  
  2927.      DGELQF computes an LQ factorization of a real M-by-N matrix A:  A = L *
  2928.      Q.
  2929.  
  2930.      DGELS solves overdetermined or underdetermined real linear systems
  2931.      involving an M-by-N matrix A, or its transpose, using a QR or LQ
  2932.      factorization of A.  It is assumed that A has full rank.
  2933.  
  2934.      DGELSS computes the minimum norm solution to a real linear least squares
  2935.      problem:
  2936.  
  2937.      Minimize 2-norm(| b - A*x |).
  2938.  
  2939.      DGELSX computes the minimum-norm solution to a real linear least squares
  2940.      problem:
  2941.          minimize || A * X - B ||
  2942.  
  2943.      DGEQL2 computes a QL factorization of a real m by n matrix A:  A = Q * L.
  2944.  
  2945.      DGEQLF computes a QL factorization of a real M-by-N matrix A:  A = Q * L.
  2946.  
  2947.      DGEQPF computes a QR factorization with column pivoting of a real M-by-N
  2948.      matrix A: A*P = Q*R.
  2949.  
  2950.      DGEQR2 computes a QR factorization of a real m by n matrix A:  A = Q * R.
  2951.  
  2952.      DGEQRF computes a QR factorization of a real M-by-N matrix A:  A = Q * R.
  2953.  
  2954.      DGERFS improves the computed solution to a system of linear equations and
  2955.      provides error bounds and backward error estimates for the solution.
  2956.  
  2957.      DGERQ2 computes an RQ factorization of a real m by n matrix A:  A = R *
  2958.      Q.
  2959.  
  2960.      DGERQF computes an RQ factorization of a real M-by-N matrix A:  A = R *
  2961.      Q.
  2962.  
  2963.      DGESV computes the solution to a real system of linear equations
  2964.  
  2965.  
  2966.  
  2967.                                                                        PPPPaaaaggggeeee 44445555
  2968.  
  2969.  
  2970.  
  2971.  
  2972.  
  2973.  
  2974. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  2975.  
  2976.  
  2977.  
  2978.         A * X = B, where A is an N-by-N matrix and X and B are N-by-NRHS
  2979.      matrices.
  2980.  
  2981.      DGESVD computes the singular value decomposition (SVD) of a real M-by-N
  2982.      matrix A, optionally computing the left and/or right singular vectors.
  2983.      The SVD is written
  2984.  
  2985.           A = U * SIGMA * transpose(V)
  2986.  
  2987.      DGESVX uses the LU factorization to compute the solution to a real system
  2988.      of linear equations
  2989.         A * X = B, where A is an N-by-N matrix and X and B are N-by-NRHS
  2990.      matrices.
  2991.  
  2992.      DGETF2 computes an LU factorization of a general m-by-n matrix A using
  2993.      partial pivoting with row interchanges.
  2994.  
  2995.      DGETRF computes an LU factorization of a general M-by-N matrix A using
  2996.      partial pivoting with row interchanges.
  2997.  
  2998.      DGETRI computes the inverse of a matrix using the LU factorization
  2999.      computed by DGETRF.
  3000.  
  3001.      DGETRS solves a system of linear equations
  3002.         A * X = B  or  A' * X = B with a general N-by-N matrix A using the LU
  3003.      factorization computed by DGETRF.
  3004.  
  3005.      DGGBAK forms the right or left eigenvectors of the generalized eigenvalue
  3006.      problem by backward transformation on the computed eigenvectors of the
  3007.      balanced matrix output by DGGBAL.
  3008.  
  3009.      DGGBAL balances a pair of general real matrices (A,B) for the generalized
  3010.      eigenvalue problem A*X = lambda*B*X.  This involves, first, permuting A
  3011.      and B by similarity transformations to isolate eigenvalues in the first 1
  3012.      to ILO-1 and last IHI+1 to N elements on the diagonal; and second,
  3013.      applying a diagonal similarity
  3014.  
  3015.      DGGGLM solves a generalized linear regression model (GLM) problem:
  3016.  
  3017.              minimize y'*y     subject to    d = A*x + B*y
  3018.  
  3019.      DGGHRD reduces a pair of real matrices (A,B) to generalized upper
  3020.      Hessenberg form using orthogonal similarity transformations, where A is a
  3021.      (generally non-symmetric) square matrix and B is upper triangular.  More
  3022.      precisely, DGGHRD simultaneously decomposes  A into  Q H Z' and  B  into
  3023.      Q T Z' , where H is upper Hessenberg, T is upper triangular, Q and Z are
  3024.      orthogonal, and ' means transpose.
  3025.  
  3026.      DGGLSE solves the linear equality constrained least squares (LSE)
  3027.      problem:
  3028.  
  3029.              minimize || A*x - c ||_2   subject to B*x = d
  3030.  
  3031.  
  3032.  
  3033.                                                                        PPPPaaaaggggeeee 44446666
  3034.  
  3035.  
  3036.  
  3037.  
  3038.  
  3039.  
  3040. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  3041.  
  3042.  
  3043.  
  3044.      DGGQRF computes a generalized QR factorization of an N-by-M matrix A and
  3045.      an N-by-P matrix B:
  3046.  
  3047.                  A = Q*R,        B = Q*T*Z,
  3048.  
  3049.      DGGRQF computes a generalized RQ factorization of an M-by-N matrix A and
  3050.      a P-by-N matrix B:
  3051.  
  3052.                  A = R*Q,        B = Z*T*Q,
  3053.  
  3054.      DGGSVD computes the generalized singular value decomposition (GSVD) of
  3055.      the M-by-N matrix A and P-by-N matrix B:
  3056.  
  3057.          U'*A*Q = D1*( 0 R ),    V'*B*Q = D2*( 0 R )               (1)
  3058.  
  3059.      where U, V and Q are orthogonal matrices, and Z' is the transpose of Z.
  3060.      Let K+L = the numerical effective rank of the matrix (A',B')', then R is
  3061.      a K+L-by-K+L nonsingular upper tridiagonal matrix, D1 and D2 are
  3062.      "diagonal" matrices, and of the following structures, respectively:
  3063.  
  3064.      DGGSVP computes orthogonal matrices U, V and Q such that A23 is upper
  3065.      trapezoidal.  K+L = the effective rank of (M+P)-by-N matrix (A',B')'.  Z'
  3066.      denotes the transpose of Z.
  3067.  
  3068.      DGTCON estimates the reciprocal of the condition number of a real
  3069.      tridiagonal matrix A using the LU factorization as computed by DGTTRF.
  3070.  
  3071.      DGTRFS improves the computed solution to a system of linear equations
  3072.      when the coefficient matrix is tridiagonal, and provides error bounds and
  3073.      backward error estimates for the solution.
  3074.  
  3075.      DGTSV  solves the equation
  3076.  
  3077.      where A is an N-by-N tridiagonal matrix, by Gaussian elimination with
  3078.      partial pivoting.
  3079.  
  3080.      DGTSVX uses the LU factorization to compute the solution to a real system
  3081.      of linear equations A * X = B or A**T * X = B, where A is a tridiagonal
  3082.      matrix of order N and X and B are N-by-NRHS matrices.
  3083.  
  3084.      DGTTRF computes an LU factorization of a real tridiagonal matrix A using
  3085.      elimination with partial pivoting and row interchanges.
  3086.  
  3087.      DGTTRS solves one of the systems of equations
  3088.         A*X = B  or  A'*X = B, with a tridiagonal matrix A using the LU
  3089.      factorization computed by DGTTRF.
  3090.  
  3091.      DHGEQZ implements a single-/double-shift version of the QZ method for
  3092.      finding the generalized eigenvalues B is upper triangular, and A is block
  3093.      upper triangular, where the diagonal blocks are either 1x1 or 2x2, the
  3094.      2x2 blocks having complex generalized eigenvalues (see the description of
  3095.      the argument JOB.)
  3096.  
  3097.  
  3098.  
  3099.                                                                        PPPPaaaaggggeeee 44447777
  3100.  
  3101.  
  3102.  
  3103.  
  3104.  
  3105.  
  3106. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  3107.  
  3108.  
  3109.  
  3110.      If JOB='S', then the pair (A,B) is simultaneously reduced to Schur form
  3111.      using one orthogonal tranformation (usually called Q) on the left and
  3112.      another (usually called Z) on the right.  The 2x2 upper-triangular
  3113.      diagonal blocks of B corresponding to 2x2 blocks of A will be reduced to
  3114.      positive diagonal matrices.  (I.e., if A(j+1,j) is non-zero, then
  3115.      B(j+1,j)=B(j,j+1)=0 and B(j,j) and B(j+1,j+1) will be positive.)
  3116.  
  3117.      DHSEIN uses inverse iteration to find specified right and/or left
  3118.      eigenvectors of a real upper Hessenberg matrix H.
  3119.  
  3120.      DHSEQR computes the eigenvalues of a real upper Hessenberg matrix H and,
  3121.      optionally, the matrices T and Z from the Schur decomposition H = Z T
  3122.      Z**T, where T is an upper quasi-triangular matrix (the Schur form), and Z
  3123.      is the orthogonal matrix of Schur vectors.
  3124.  
  3125.      DLABAD takes as input the values computed by SLAMCH for underflow and
  3126.      overflow, and returns the square root of each of these values if the log
  3127.      of LARGE is sufficiently large.  This subroutine is intended to identify
  3128.      machines with a large exponent range, such as the Crays, and redefine the
  3129.      underflow and overflow limits to be the square roots of the values
  3130.      computed by DLAMCH.  This subroutine is needed because DLAMCH does not
  3131.      compensate for poor arithmetic in the upper half of the exponent range,
  3132.      as is found on a Cray.
  3133.  
  3134.      DLABRD reduces the first NB rows and columns of a real general m by n
  3135.      matrix A to upper or lower bidiagonal form by an orthogonal
  3136.      transformation Q' * A * P, and returns the matrices X and Y which are
  3137.      needed to apply the transformation to the unreduced part of A.
  3138.  
  3139.      DLACON estimates the 1-norm of a square, real matrix A.  Reverse
  3140.      communication is used for evaluating matrix-vector products.
  3141.  
  3142.      DLACPY copies all or part of a two-dimensional matrix A to another matrix
  3143.      B.
  3144.  
  3145.      DLADIV performs complex division in  real arithmetic in D. Knuth, The art
  3146.      of Computer Programming, Vol.2, p.195
  3147.  
  3148.  
  3149.      DLAE2  computes the eigenvalues of a 2-by-2 symmetric matrix
  3150.         [  A   B  ]
  3151.         [  B   C  ].  On return, RT1 is the eigenvalue of larger absolute
  3152.      value, and RT2 is the eigenvalue of smaller absolute value.
  3153.  
  3154.      DLAEBZ contains the iteration loops which compute and use the function
  3155.      N(w), which is the count of eigenvalues of a symmetric tridiagonal matrix
  3156.      T less than or equal to its argument  w.  It performs a choice of two
  3157.      types of loops:
  3158.  
  3159.      DLAEIN uses inverse iteration to find a right or left eigenvector
  3160.      corresponding to the eigenvalue (WR,WI) of a real upper Hessenberg matrix
  3161.      H.
  3162.  
  3163.  
  3164.  
  3165.                                                                        PPPPaaaaggggeeee 44448888
  3166.  
  3167.  
  3168.  
  3169.  
  3170.  
  3171.  
  3172. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  3173.  
  3174.  
  3175.  
  3176.      DLAEV2 computes the eigendecomposition of a 2-by-2 symmetric matrix
  3177.         [  A   B  ]
  3178.         [  B   C  ].  On return, RT1 is the eigenvalue of larger absolute
  3179.      value, RT2 is the eigenvalue of smaller absolute value, and (CS1,SN1) is
  3180.      the unit right eigenvector for RT1, giving the decomposition
  3181.  
  3182.      DLAEXC swaps adjacent diagonal blocks T11 and T22 of order 1 or 2 in an
  3183.      upper quasi-triangular matrix T by an orthogonal similarity
  3184.      transformation.
  3185.  
  3186.      DLAG2 computes the eigenvalues of a 2 x 2 generalized eigenvalue problem
  3187.      A - w B, with scaling as necessary to avoid over-/underflow.
  3188.  
  3189.      DLAGS2 computes 2-by-2 orthogonal matrices U, V and Q, such that if (
  3190.      UPPER ) then
  3191.  
  3192.  
  3193.  
  3194.      DLAGTF factorizes the matrix (T - lambda*I), where T is an n by n
  3195.      tridiagonal matrix and lambda is a scalar, as
  3196.  
  3197.      where P is a permutation matrix, L is a unit lower tridiagonal matrix
  3198.      with at most one non-zero sub-diagonal elements per column and U is an
  3199.      upper triangular matrix with at most two non-zero super-diagonal elements
  3200.      per column.
  3201.  
  3202.      DLAGTM performs a matrix-vector product of the form
  3203.  
  3204.  
  3205.      DLAGTS may be used to solve one of the systems of equations
  3206.  
  3207.      where T is an n by n tridiagonal matrix, for x, following the
  3208.      factorization of (T - lambda*I) as
  3209.  
  3210.      DLAHQR is an auxiliary routine called by DHSEQR to update the eigenvalues
  3211.      and Schur decomposition already computed by DHSEQR, by dealing with the
  3212.      Hessenberg submatrix in rows and columns ILO to IHI.
  3213.  
  3214.      DLAHRD reduces the first NB columns of a real general n-by-(n-k+1) matrix
  3215.      A so that elements below the k-th subdiagonal are zero. The reduction is
  3216.      performed by an orthogonal similarity transformation Q' * A * Q. The
  3217.      routine returns the matrices V and T which determine Q as a block
  3218.      reflector I - V*T*V', and also the matrix Y = A * V * T.
  3219.  
  3220.      DLAIC1 applies one step of incremental condition estimation in its
  3221.      simplest version:
  3222.  
  3223.      Let x, twonorm(x) = 1, be an approximate singular vector of an j-by-j
  3224.      lower triangular matrix L, such that
  3225.  
  3226.      DLALN2 solves a system of the form  (ca A - w D ) X = s B or (ca A' - w
  3227.      D) X = s B   with possible scaling ("s") and perturbation of A.  (A'
  3228.  
  3229.  
  3230.  
  3231.                                                                        PPPPaaaaggggeeee 44449999
  3232.  
  3233.  
  3234.  
  3235.  
  3236.  
  3237.  
  3238. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  3239.  
  3240.  
  3241.  
  3242.      means A-transpose.)
  3243.  
  3244.      A is an NA x NA real matrix, ca is a real scalar, D is an NA x NA real
  3245.      diagonal matrix, w is a real or complex value, and X and B are NA x 1
  3246.      matrices -- real if w is real, complex if w is complex.  NA may be 1 or
  3247.      2.
  3248.  
  3249.      DLAMCH determines double precision machine parameters.
  3250.  
  3251.      DLANGB  returns the value of the one norm,  or the Frobenius norm, or the
  3252.      infinity norm,  or the element of  largest absolute value  of an n by n
  3253.      band matrix  A,  with kl sub-diagonals and ku super-diagonals.
  3254.  
  3255.      DLANGE  returns the value of the one norm,  or the Frobenius norm, or the
  3256.      infinity norm,  or the  element of  largest absolute value  of a real
  3257.      matrix A.
  3258.  
  3259.      DLANGT  returns the value of the one norm,  or the Frobenius norm, or the
  3260.      infinity norm,  or the  element of  largest absolute value  of a real
  3261.      tridiagonal matrix A.
  3262.  
  3263.      DLANHS  returns the value of the one norm,  or the Frobenius norm, or the
  3264.      infinity norm,  or the  element of  largest absolute value  of a
  3265.      Hessenberg matrix A.
  3266.  
  3267.      DLANSB  returns the value of the one norm,  or the Frobenius norm, or the
  3268.      infinity norm,  or the element of  largest absolute value  of an n by n
  3269.      symmetric band matrix A,  with k super-diagonals.
  3270.  
  3271.      DLANSP  returns the value of the one norm,  or the Frobenius norm, or the
  3272.      infinity norm,  or the  element of  largest absolute value  of a real
  3273.      symmetric matrix A,  supplied in packed form.
  3274.  
  3275.      DLANST  returns the value of the one norm,  or the Frobenius norm, or the
  3276.      infinity norm,  or the  element of  largest absolute value  of a real
  3277.      symmetric tridiagonal matrix A.
  3278.  
  3279.      DLANSY  returns the value of the one norm,  or the Frobenius norm, or the
  3280.      infinity norm,  or the  element of  largest absolute value  of a real
  3281.      symmetric matrix A.
  3282.  
  3283.      DLANTB  returns the value of the one norm,  or the Frobenius norm, or the
  3284.      infinity norm,  or the element of  largest absolute value  of an n by n
  3285.      triangular band matrix A,  with ( k + 1 ) diagonals.
  3286.  
  3287.      DLANTP  returns the value of the one norm,  or the Frobenius norm, or the
  3288.      infinity norm,  or the  element of  largest absolute value  of a
  3289.      triangular matrix A, supplied in packed form.
  3290.  
  3291.      DLANTR  returns the value of the one norm,  or the Frobenius norm, or the
  3292.      infinity norm,  or the  element of  largest absolute value  of a
  3293.      trapezoidal or triangular matrix A.
  3294.  
  3295.  
  3296.  
  3297.                                                                        PPPPaaaaggggeeee 55550000
  3298.  
  3299.  
  3300.  
  3301.  
  3302.  
  3303.  
  3304. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  3305.  
  3306.  
  3307.  
  3308.      DLANV2 computes the Schur factorization of a real 2-by-2 nonsymmetric
  3309.      matrix in standard form:
  3310.  
  3311.           [ A  B ] = [ CS -SN ] [ AA  BB ] [ CS  SN ]
  3312.  
  3313.      Given two column vectors X and Y, let
  3314.  
  3315.      The subroutine first computes the QR factorization of A = Q*R, and then
  3316.      computes the SVD of the 2-by-2 upper triangular matrix R.  The smaller
  3317.      singular value of R is returned in SSMIN, which is used as the
  3318.      measurement of the linear dependency of the vectors X and Y.
  3319.  
  3320.      DLAPMT rearranges the columns of the M by N matrix X as specified by the
  3321.      permutation K(1),K(2),...,K(N) of the integers 1,...,N.  If FORWRD =
  3322.      .TRUE.,  forward permutation:
  3323.  
  3324.      DLAPY2 returns sqrt(x**2+y**2), taking care not to cause unnecessary
  3325.      overflow.
  3326.  
  3327.      DLAPY3 returns sqrt(x**2+y**2+z**2), taking care not to cause unnecessary
  3328.      overflow.
  3329.  
  3330.      DLAQGB equilibrates a general M by N band matrix A with KL subdiagonals
  3331.      and KU superdiagonals using the row and scaling factors in the vectors R
  3332.      and C.
  3333.  
  3334.      DLAQGE equilibrates a general M by N matrix A using the row and scaling
  3335.      factors in the vectors R and C.
  3336.  
  3337.      DLAQSB equilibrates a symmetric band matrix A using the scaling factors
  3338.      in the vector S.
  3339.  
  3340.      DLAQSP equilibrates a symmetric matrix A using the scaling factors in the
  3341.      vector S.
  3342.  
  3343.      DLAQSY equilibrates a symmetric matrix A using the scaling factors in the
  3344.      vector S.
  3345.  
  3346.      DLAQTR solves the real quasi-triangular system
  3347.  
  3348.      or the complex quasi-triangular systems
  3349.  
  3350.      DLAR2V applies a vector of real plane rotations from both sides to a
  3351.      sequence of 2-by-2 real symmetric matrices, defined by the elements of
  3352.      the vectors x, y and z. For i = 1,2,...,n
  3353.  
  3354.         ( x(i)  z(i) ) := (  c(i)  s(i) ) ( x(i)  z(i) ) ( c(i) -s(i) )
  3355.         ( z(i)  y(i) )    ( -s(i)  c(i) ) ( z(i)  y(i) ) ( s(i)  c(i) )
  3356.  
  3357.  
  3358.      DLARF applies a real elementary reflector H to a real m by n matrix C,
  3359.      from either the left or the right. H is represented in the form
  3360.  
  3361.  
  3362.  
  3363.                                                                        PPPPaaaaggggeeee 55551111
  3364.  
  3365.  
  3366.  
  3367.  
  3368.  
  3369.  
  3370. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  3371.  
  3372.  
  3373.  
  3374.            H = I - tau * v * v'
  3375.  
  3376.      DLARFB applies a real block reflector H or its transpose H' to a real m
  3377.      by n matrix C, from either the left or the right.
  3378.  
  3379.      DLARFG generates a real elementary reflector H of order n, such that
  3380.                (   x   )   (   0  )
  3381.  
  3382.      DLARFT forms the triangular factor T of a real block reflector H of order
  3383.      n, which is defined as a product of k elementary reflectors.
  3384.  
  3385.      DLARFX applies a real elementary reflector H to a real m by n matrix C,
  3386.      from either the left or the right. H is represented in the form
  3387.  
  3388.      DLARGV generates a vector of real plane rotations, determined by elements
  3389.      of the real vectors x and y. For i = 1,2,...,n
  3390.  
  3391.         (  c(i)  s(i) ) ( x(i) ) = ( a(i) )
  3392.  
  3393.      DLARNV returns a vector of n random real numbers from a uniform or normal
  3394.      distribution.
  3395.  
  3396.      DLARTG generate a plane rotation so that
  3397.         [ -SN  CS  ]     [ G ]     [ 0 ]
  3398.  
  3399.      DLARTV applies a vector of real plane rotations to elements of the real
  3400.      vectors x and y. For i = 1,2,...,n
  3401.  
  3402.         ( x(i) ) := (  c(i)  s(i) ) ( x(i) )
  3403.  
  3404.      DLARUV returns a vector of n random real numbers from a uniform (0,1)
  3405.      distribution (n <= 128).
  3406.  
  3407.      DLAS2  computes the singular values of the 2-by-2 matrix
  3408.         [  F   G  ]
  3409.         [  0   H  ].  On return, SSMIN is the smaller singular value and SSMAX
  3410.      is the larger singular value.
  3411.  
  3412.      DLASCL multiplies the M by N real matrix A by the real scalar CTO/CFROM.
  3413.      This is done without over/underflow as long as the final result
  3414.      CTO*A(I,J)/CFROM does not over/underflow. TYPE specifies that A may be
  3415.      full, upper triangular, lower triangular, upper Hessenberg, or banded.
  3416.  
  3417.      DLASET initializes an m-by-n matrix A to BETA on the diagonal and ALPHA
  3418.      on the offdiagonals.
  3419.  
  3420.      DLASR   performs the transformation consisting of a sequence of plane
  3421.      rotations determined by the parameters PIVOT and DIRECT as follows ( z =
  3422.      m when SIDE = 'L' or 'l' and z = n when SIDE = 'R' or 'r' ):
  3423.  
  3424.      DLASSQ  returns the values  scl  and  smsq  such that
  3425.  
  3426.  
  3427.  
  3428.  
  3429.                                                                        PPPPaaaaggggeeee 55552222
  3430.  
  3431.  
  3432.  
  3433.  
  3434.  
  3435.  
  3436. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  3437.  
  3438.  
  3439.  
  3440.      where  x( i ) = X( 1 + ( i - 1 )*INCX ). The value of  sumsq  is assumed
  3441.      to be non-negative and  scl  returns the value
  3442.  
  3443.      DLASV2 computes the singular value decomposition of a 2-by-2 triangular
  3444.      matrix
  3445.         [  F   G  ]
  3446.         [  0   H  ].  On return, abs(SSMAX) is the larger singular value,
  3447.      abs(SSMIN) is the smaller singular value, and (CSL,SNL) and (CSR,SNR) are
  3448.      the left and right singular vectors for abs(SSMAX), giving the
  3449.      decomposition
  3450.  
  3451.         [ CSL  SNL ] [  F   G  ] [ CSR -SNR ]  =  [ SSMAX   0   ]
  3452.         [-SNL  CSL ] [  0   H  ] [ SNR  CSR ]     [  0    SSMIN ].
  3453.  
  3454.      DLASWP performs a series of row interchanges on the matrix A.  One row
  3455.      interchange is initiated for each of rows K1 through K2 of A.
  3456.  
  3457.      DLASY2 solves for the N1 by N2 matrix X, 1 <= N1,N2 <= 2, in
  3458.  
  3459.      where TL is N1 by N1, TR is N2 by N2, B is N1 by N2, and ISGN = 1 or -1.
  3460.      op(T) = T or T', where T' denotes the transpose of T.
  3461.  
  3462.      DLASYF computes a partial factorization of a real symmetric matrix A
  3463.      using the Bunch-Kaufman diagonal pivoting method. The partial
  3464.      factorization has the form:
  3465.  
  3466.      DLATBS solves one of the triangular systems are n-element vectors, and s
  3467.      is a scaling factor, usually less than or equal to 1, chosen so that the
  3468.      components of x will be less than the overflow threshold.  If the
  3469.      unscaled problem will not cause overflow, the Level 2 BLAS routine DTBSV
  3470.      is called.  If the matrix A is singular (A(j,j) = 0 for some j), then s
  3471.      is set to 0 and a non-trivial solution to A*x = 0 is returned.
  3472.  
  3473.      DLATPS solves one of the triangular systems transpose of A, x and b are
  3474.      n-element vectors, and s is a scaling factor, usually less than or equal
  3475.      to 1, chosen so that the components of x will be less than the overflow
  3476.      threshold.  If the unscaled problem will not cause overflow, the Level 2
  3477.      BLAS routine DTPSV is called. If the matrix A is singular (A(j,j) = 0 for
  3478.      some j), then s is set to 0 and a non-trivial solution to A*x = 0 is
  3479.      returned.
  3480.  
  3481.      DLATRD reduces NB rows and columns of a real symmetric matrix A to
  3482.      symmetric tridiagonal form by an orthogonal similarity transformation Q'
  3483.      * A * Q, and returns the matrices V and W which are needed to apply the
  3484.      transformation to the unreduced part of A.
  3485.  
  3486.      DLATRS solves one of the triangular systems triangular matrix, A' denotes
  3487.      the transpose of A, x and b are n-element vectors, and s is a scaling
  3488.      factor, usually less than or equal to 1, chosen so that the components of
  3489.      x will be less than the overflow threshold.  If the unscaled problem will
  3490.      not cause overflow, the Level 2 BLAS routine DTRSV is called.  If the
  3491.      matrix A is singular (A(j,j) = 0 for some j), then s is set to 0 and a
  3492.  
  3493.  
  3494.  
  3495.                                                                        PPPPaaaaggggeeee 55553333
  3496.  
  3497.  
  3498.  
  3499.  
  3500.  
  3501.  
  3502. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  3503.  
  3504.  
  3505.  
  3506.      non-trivial solution to A*x = 0 is returned.
  3507.  
  3508.      DLATZM applies a Householder matrix generated by DTZRQF to a matrix.
  3509.  
  3510.      DLAUU2 computes the product U * U' or L' * L, where the triangular factor
  3511.      U or L is stored in the upper or lower triangular part of the array A.
  3512.  
  3513.      DLAUUM computes the product U * U' or L' * L, where the triangular factor
  3514.      U or L is stored in the upper or lower triangular part of the array A.
  3515.  
  3516.      DLAZRO initializes a 2-D array A to BETA on the diagonal and ALPHA on the
  3517.      offdiagonals.
  3518.  
  3519.      DOPGTR generates a real orthogonal matrix Q which is defined as the
  3520.      product of n-1 elementary reflectors of order n, as returned by DSPTRD
  3521.      using packed storage:
  3522.  
  3523.      if UPLO = 'U', Q = H(n-1) . . . H(2) H(1),
  3524.  
  3525.      DOPMTR overwrites the general real M-by-N matrix C with TRANS = 'T':
  3526.      Q**T * C       C * Q**T
  3527.  
  3528.      DORG2L generates an m by n real matrix Q with orthonormal columns, which
  3529.      is defined as the last n columns of a product of k elementary reflectors
  3530.      of order m
  3531.  
  3532.      DORG2R generates an m by n real matrix Q with orthonormal columns, which
  3533.      is defined as the first n columns of a product of k elementary reflectors
  3534.      of order m
  3535.  
  3536.      DORGBR generates one of the matrices Q or P**T determined by DGEBRD when
  3537.      reducing a real matrix A to bidiagonal form: A = Q * B * P**T.  Q and
  3538.      P**T are defined as products of elementary reflectors H(i) or G(i)
  3539.      respectively.
  3540.  
  3541.      DORGHR generates a real orthogonal matrix Q which is defined as the
  3542.      product of IHI-ILO elementary reflectors of order N, as returned by
  3543.      DGEHRD:
  3544.  
  3545.      Q = H(ilo) H(ilo+1) . . . H(ihi-1).
  3546.  
  3547.      DORGL2 generates an m by n real matrix Q with orthonormal rows, which is
  3548.      defined as the first m rows of a product of k elementary reflectors of
  3549.      order n
  3550.  
  3551.      DORGLQ generates an M-by-N real matrix Q with orthonormal rows, which is
  3552.      defined as the first M rows of a product of K elementary reflectors of
  3553.      order N
  3554.  
  3555.      DORGQL generates an M-by-N real matrix Q with orthonormal columns, which
  3556.      is defined as the last N columns of a product of K elementary reflectors
  3557.      of order M
  3558.  
  3559.  
  3560.  
  3561.                                                                        PPPPaaaaggggeeee 55554444
  3562.  
  3563.  
  3564.  
  3565.  
  3566.  
  3567.  
  3568. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  3569.  
  3570.  
  3571.  
  3572.      DORGQR generates an M-by-N real matrix Q with orthonormal columns, which
  3573.      is defined as the first N columns of a product of K elementary reflectors
  3574.      of order M
  3575.  
  3576.      DORGR2 generates an m by n real matrix Q with orthonormal rows, which is
  3577.      defined as the last m rows of a product of k elementary reflectors of
  3578.      order n
  3579.  
  3580.      DORGRQ generates an M-by-N real matrix Q with orthonormal rows, which is
  3581.      defined as the last M rows of a product of K elementary reflectors of
  3582.      order N
  3583.  
  3584.      DORGTR generates a real orthogonal matrix Q which is defined as the
  3585.      product of n-1 elementary reflectors of order N, as returned by DSYTRD:
  3586.  
  3587.      if UPLO = 'U', Q = H(n-1) . . . H(2) H(1),
  3588.  
  3589.      DORM2L overwrites the general real m by n matrix C with
  3590.  
  3591.      where Q is a real orthogonal matrix defined as the product of k
  3592.      elementary reflectors
  3593.  
  3594.      DORM2R overwrites the general real m by n matrix C with
  3595.  
  3596.      where Q is a real orthogonal matrix defined as the product of k
  3597.      elementary reflectors
  3598.  
  3599.      If VECT = 'Q', DORMBR overwrites the general real M-by-N matrix C with
  3600.                      SIDE = 'L'     SIDE = 'R' TRANS = 'N':      Q * C
  3601.      C * Q TRANS = 'T':      Q**T * C       C * Q**T
  3602.  
  3603.      DORMHR overwrites the general real M-by-N matrix C with TRANS = 'T':
  3604.      Q**T * C       C * Q**T
  3605.  
  3606.      DORML2 overwrites the general real m by n matrix C with
  3607.  
  3608.      where Q is a real orthogonal matrix defined as the product of k
  3609.      elementary reflectors
  3610.  
  3611.      DORMLQ overwrites the general real M-by-N matrix C with TRANS = 'T':
  3612.      Q**T * C       C * Q**T
  3613.  
  3614.      DORMQL overwrites the general real M-by-N matrix C with TRANS = 'T':
  3615.      Q**T * C       C * Q**T
  3616.  
  3617.      DORMQR overwrites the general real M-by-N matrix C with TRANS = 'T':
  3618.      Q**T * C       C * Q**T
  3619.  
  3620.      DORMR2 overwrites the general real m by n matrix C with
  3621.  
  3622.      where Q is a real orthogonal matrix defined as the product of k
  3623.      elementary reflectors
  3624.  
  3625.  
  3626.  
  3627.                                                                        PPPPaaaaggggeeee 55555555
  3628.  
  3629.  
  3630.  
  3631.  
  3632.  
  3633.  
  3634. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  3635.  
  3636.  
  3637.  
  3638.      DORMRQ overwrites the general real M-by-N matrix C with TRANS = 'T':
  3639.      Q**T * C       C * Q**T
  3640.  
  3641.      DORMTR overwrites the general real M-by-N matrix C with TRANS = 'T':
  3642.      Q**T * C       C * Q**T
  3643.  
  3644.      DPBCON estimates the reciprocal of the condition number (in the 1-norm)
  3645.      of a real symmetric positive definite band matrix using the Cholesky
  3646.      factorization A = U**T*U or A = L*L**T computed by DPBTRF.
  3647.  
  3648.      DPBEQU computes row and column scalings intended to equilibrate a
  3649.      symmetric positive definite band matrix A and reduce its condition number
  3650.      (with respect to the two-norm).  S contains the scale factors, S(i) =
  3651.      1/sqrt(A(i,i)), chosen so that the scaled matrix B with elements B(i,j) =
  3652.      S(i)*A(i,j)*S(j) has ones on the diagonal.  This choice of S puts the
  3653.      condition number of B within a factor N of the smallest possible
  3654.      condition number over all possible diagonal scalings.
  3655.  
  3656.      DPBRFS improves the computed solution to a system of linear equations
  3657.      when the coefficient matrix is symmetric positive definite and banded,
  3658.      and provides error bounds and backward error estimates for the solution.
  3659.  
  3660.      DPBSV computes the solution to a real system of linear equations
  3661.         A * X = B, where A is an N-by-N symmetric positive definite band
  3662.      matrix and X and B are N-by-NRHS matrices.
  3663.  
  3664.      DPBSVX uses the Cholesky factorization A = U**T*U or A = L*L**T to
  3665.      compute the solution to a real system of linear equations
  3666.         A * X = B, where A is an N-by-N symmetric positive definite band
  3667.      matrix and X and B are N-by-NRHS matrices.
  3668.  
  3669.      DPBTF2 computes the Cholesky factorization of a real symmetric positive
  3670.      definite band matrix A.
  3671.  
  3672.      DPBTRF computes the Cholesky factorization of a real symmetric positive
  3673.      definite band matrix A.
  3674.  
  3675.      DPBTRS solves a system of linear equations A*X = B with a symmetric
  3676.      positive definite band matrix A using the Cholesky factorization A =
  3677.      U**T*U or A = L*L**T computed by DPBTRF.
  3678.  
  3679.      DPOCON estimates the reciprocal of the condition number (in the 1-norm)
  3680.      of a real symmetric positive definite matrix using the Cholesky
  3681.      factorization A = U**T*U or A = L*L**T computed by DPOTRF.
  3682.  
  3683.      DPOEQU computes row and column scalings intended to equilibrate a
  3684.      symmetric positive definite matrix A and reduce its condition number
  3685.      (with respect to the two-norm).  S contains the scale factors, S(i) =
  3686.      1/sqrt(A(i,i)), chosen so that the scaled matrix B with elements B(i,j) =
  3687.      S(i)*A(i,j)*S(j) has ones on the diagonal.  This choice of S puts the
  3688.      condition number of B within a factor N of the smallest possible
  3689.      condition number over all possible diagonal scalings.
  3690.  
  3691.  
  3692.  
  3693.                                                                        PPPPaaaaggggeeee 55556666
  3694.  
  3695.  
  3696.  
  3697.  
  3698.  
  3699.  
  3700. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  3701.  
  3702.  
  3703.  
  3704.      DPORFS improves the computed solution to a system of linear equations
  3705.      when the coefficient matrix is symmetric positive definite, and provides
  3706.      error bounds and backward error estimates for the solution.
  3707.  
  3708.      DPOSV computes the solution to a real system of linear equations
  3709.         A * X = B, where A is an N-by-N symmetric positive definite matrix and
  3710.      X and B are N-by-NRHS matrices.
  3711.  
  3712.      DPOSVX uses the Cholesky factorization A = U**T*U or A = L*L**T to
  3713.      compute the solution to a real system of linear equations
  3714.         A * X = B, where A is an N-by-N symmetric positive definite matrix and
  3715.      X and B are N-by-NRHS matrices.
  3716.  
  3717.      DPOTF2 computes the Cholesky factorization of a real symmetric positive
  3718.      definite matrix A.
  3719.  
  3720.      DPOTRF computes the Cholesky factorization of a real symmetric positive
  3721.      definite matrix A.
  3722.  
  3723.      DPOTRI computes the inverse of a real symmetric positive definite matrix
  3724.      A using the Cholesky factorization A = U**T*U or A = L*L**T computed by
  3725.      DPOTRF.
  3726.  
  3727.      DPOTRS solves a system of linear equations A*X = B with a symmetric
  3728.      positive definite matrix A using the Cholesky factorization A = U**T*U or
  3729.      A = L*L**T computed by DPOTRF.
  3730.  
  3731.      DPPCON estimates the reciprocal of the condition number (in the 1-norm)
  3732.      of a real symmetric positive definite packed matrix using the Cholesky
  3733.      factorization A = U**T*U or A = L*L**T computed by DPPTRF.
  3734.  
  3735.      DPPEQU computes row and column scalings intended to equilibrate a
  3736.      symmetric positive definite matrix A in packed storage and reduce its
  3737.      condition number (with respect to the two-norm).  S contains the scale
  3738.      factors, S(i)=1/sqrt(A(i,i)), chosen so that the scaled matrix B with
  3739.      elements B(i,j)=S(i)*A(i,j)*S(j) has ones on the diagonal.  This choice
  3740.      of S puts the condition number of B within a factor N of the smallest
  3741.      possible condition number over all possible diagonal scalings.
  3742.  
  3743.      DPPRFS improves the computed solution to a system of linear equations
  3744.      when the coefficient matrix is symmetric positive definite and packed,
  3745.      and provides error bounds and backward error estimates for the solution.
  3746.  
  3747.      DPPSV computes the solution to a real system of linear equations
  3748.         A * X = B, where A is an N-by-N symmetric positive definite matrix
  3749.      stored in packed format and X and B are N-by-NRHS matrices.
  3750.  
  3751.      DPPSVX uses the Cholesky factorization A = U**T*U or A = L*L**T to
  3752.      compute the solution to a real system of linear equations
  3753.         A * X = B, where A is an N-by-N symmetric positive definite matrix
  3754.      stored in packed format and X and B are N-by-NRHS matrices.
  3755.  
  3756.  
  3757.  
  3758.  
  3759.                                                                        PPPPaaaaggggeeee 55557777
  3760.  
  3761.  
  3762.  
  3763.  
  3764.  
  3765.  
  3766. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  3767.  
  3768.  
  3769.  
  3770.      DPPTRF computes the Cholesky factorization of a real symmetric positive
  3771.      definite matrix A stored in packed format.
  3772.  
  3773.      DPPTRI computes the inverse of a real symmetric positive definite matrix
  3774.      A using the Cholesky factorization A = U**T*U or A = L*L**T computed by
  3775.      DPPTRF.
  3776.  
  3777.      DPPTRS solves a system of linear equations A*X = B with a symmetric
  3778.      positive definite matrix A in packed storage using the Cholesky
  3779.      factorization A = U**T*U or A = L*L**T computed by DPPTRF.
  3780.  
  3781.      DPTCON computes the reciprocal of the condition number (in the 1-norm) of
  3782.      a real symmetric positive definite tridiagonal matrix using the
  3783.      factorization A = L*D*L**T or A = U**T*D*U computed by DPTTRF.
  3784.  
  3785.      DPTEQR computes all eigenvalues and, optionally, eigenvectors of a
  3786.      symmetric positive definite tridiagonal matrix by first factoring the
  3787.      matrix using DPTTRF, and then calling DBDSQR to compute the singular
  3788.      values of the bidiagonal factor.
  3789.  
  3790.      DPTRFS improves the computed solution to a system of linear equations
  3791.      when the coefficient matrix is symmetric positive definite and
  3792.      tridiagonal, and provides error bounds and backward error estimates for
  3793.      the solution.
  3794.  
  3795.      DPTSV computes the solution to a real system of linear equations A*X = B,
  3796.      where A is an N-by-N symmetric positive definite tridiagonal matrix, and
  3797.      X and B are N-by-NRHS matrices.
  3798.  
  3799.      DPTSVX uses the factorization A = L*D*L**T to compute the solution to a
  3800.      real system of linear equations A*X = B, where A is an N-by-N symmetric
  3801.      positive definite tridiagonal matrix and X and B are N-by-NRHS matrices.
  3802.  
  3803.      DPTTRF computes the factorization of a real symmetric positive definite
  3804.      tridiagonal matrix A.
  3805.  
  3806.      DPTTRS solves a system of linear equations A * X = B with a symmetric
  3807.      positive definite tridiagonal matrix A using the factorization A =
  3808.      L*D*L**T or A = U**T*D*U computed by DPTTRF.  (The two forms are
  3809.      equivalent if A is real.)
  3810.  
  3811.      DRSCL multiplies an n-element real vector x by the real scalar 1/a.  This
  3812.      is done without overflow or underflow as long as
  3813.  
  3814.      DSBEV computes all the eigenvalues and, optionally, eigenvectors of a
  3815.      real symmetric band matrix A.
  3816.  
  3817.      DSBEVX computes selected eigenvalues and, optionally, eigenvectors of a
  3818.      real symmetric band matrix A.  Eigenvalues/vectors can be selected by
  3819.      specifying either a range of values or a range of indices for the desired
  3820.      eigenvalues.
  3821.  
  3822.  
  3823.  
  3824.  
  3825.                                                                        PPPPaaaaggggeeee 55558888
  3826.  
  3827.  
  3828.  
  3829.  
  3830.  
  3831.  
  3832. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  3833.  
  3834.  
  3835.  
  3836.      DSBTRD reduces a real symmetric band matrix A to symmetric tridiagonal
  3837.      form T by an orthogonal similarity transformation:  Q**T * A * Q = T.
  3838.  
  3839.      DSPCON estimates the reciprocal of the condition number (in the 1-norm)
  3840.      of a real symmetric packed matrix A using the factorization A = U*D*U**T
  3841.      or A = L*D*L**T computed by DSPTRF.
  3842.  
  3843.      DSPEV computes all the eigenvalues and, optionally, eigenvectors of a
  3844.      real symmetric matrix A in packed storage.
  3845.  
  3846.      DSPEVX computes selected eigenvalues and, optionally, eigenvectors of a
  3847.      real symmetric matrix A in packed storage.  Eigenvalues/vectors can be
  3848.      selected by specifying either a range of values or a range of indices for
  3849.      the desired eigenvalues.
  3850.  
  3851.      DSPGST reduces a real symmetric-definite generalized eigenproblem to
  3852.      standard form, using packed storage.
  3853.  
  3854.      DSPGV computes all the eigenvalues and, optionally, the eigenvectors of a
  3855.      real generalized symmetric-definite eigenproblem, of the form
  3856.      A*x=(lambda)*B*x,  A*Bx=(lambda)*x,  or B*A*x=(lambda)*x.  Here A and B
  3857.      are assumed to be symmetric, stored in packed format, and B is also
  3858.      positive definite.
  3859.  
  3860.      DSPRFS improves the computed solution to a system of linear equations
  3861.      when the coefficient matrix is symmetric indefinite and packed, and
  3862.      provides error bounds and backward error estimates for the solution.
  3863.  
  3864.      DSPSV computes the solution to a real system of linear equations
  3865.         A * X = B, where A is an N-by-N symmetric matrix stored in packed
  3866.      format and X and B are N-by-NRHS matrices.
  3867.  
  3868.      DSPSVX uses the diagonal pivoting factorization A = U*D*U**T or A =
  3869.      L*D*L**T to compute the solution to a real system of linear equations A *
  3870.      X = B, where A is an N-by-N symmetric matrix stored in packed format and
  3871.      X and B are N-by-NRHS matrices.
  3872.  
  3873.      DSPTRD reduces a real symmetric matrix A stored in packed form to
  3874.      symmetric tridiagonal form T by an orthogonal similarity transformation:
  3875.      Q**T * A * Q = T.
  3876.  
  3877.      DSPTRF computes the factorization of a real symmetric matrix A stored in
  3878.      packed format using the Bunch-Kaufman diagonal pivoting method:
  3879.  
  3880.         A = U*D*U**T  or  A = L*D*L**T
  3881.  
  3882.      DSPTRI computes the inverse of a real symmetric indefinite matrix A in
  3883.      packed storage using the factorization A = U*D*U**T or A = L*D*L**T
  3884.      computed by DSPTRF.
  3885.  
  3886.      DSPTRS solves a system of linear equations A*X = B with a real symmetric
  3887.      matrix A stored in packed format using the factorization A = U*D*U**T or
  3888.  
  3889.  
  3890.  
  3891.                                                                        PPPPaaaaggggeeee 55559999
  3892.  
  3893.  
  3894.  
  3895.  
  3896.  
  3897.  
  3898. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  3899.  
  3900.  
  3901.  
  3902.      A = L*D*L**T computed by DSPTRF.
  3903.  
  3904.      DSTEBZ computes the eigenvalues of a symmetric tridiagonal matrix T.  The
  3905.      user may ask for all eigenvalues, all eigenvalues in the half-open
  3906.      interval (VL, VU], or the IL-th through IU-th eigenvalues.
  3907.  
  3908.      DSTEIN computes the eigenvectors of a real symmetric tridiagonal matrix T
  3909.      corresponding to specified eigenvalues, using inverse iteration.
  3910.  
  3911.      DSTEQR computes all eigenvalues and, optionally, eigenvectors of a
  3912.      symmetric tridiagonal matrix using the implicit QL or QR method.  The
  3913.      eigenvectors of a full or band symmetric matrix can also be found if
  3914.      DSYTRD or DSPTRD or DSBTRD has been used to reduce this matrix to
  3915.      tridiagonal form.
  3916.  
  3917.      DSTERF computes all eigenvalues of a symmetric tridiagonal matrix using
  3918.      the Pal-Walker-Kahan variant of the QL or QR algorithm.
  3919.  
  3920.      DSTEV computes all eigenvalues and, optionally, eigenvectors of a real
  3921.      symmetric tridiagonal matrix A.
  3922.  
  3923.      DSTEVX computes selected eigenvalues and, optionally, eigenvectors of a
  3924.      real symmetric tridiagonal matrix A.  Eigenvalues/vectors can be selected
  3925.      by specifying either a range of values or a range of indices for the
  3926.      desired eigenvalues.
  3927.  
  3928.      DSYCON estimates the reciprocal of the condition number (in the 1-norm)
  3929.      of a real symmetric matrix A using the factorization A = U*D*U**T or A =
  3930.      L*D*L**T computed by DSYTRF.
  3931.  
  3932.      DSYEV computes all eigenvalues and, optionally, eigenvectors of a real
  3933.      symmetric matrix A.
  3934.  
  3935.      DSYEVX computes selected eigenvalues and, optionally, eigenvectors of a
  3936.      real symmetric matrix A.  Eigenvalues and eigenvectors can be selected by
  3937.      specifying either a range of values or a range of indices for the desired
  3938.      eigenvalues.
  3939.  
  3940.      DSYGS2 reduces a real symmetric-definite generalized eigenproblem to
  3941.      standard form.
  3942.  
  3943.      DSYGST reduces a real symmetric-definite generalized eigenproblem to
  3944.      standard form.
  3945.  
  3946.      DSYGV computes all the eigenvalues, and optionally, the eigenvectors of a
  3947.      real generalized symmetric-definite eigenproblem, of the form
  3948.      A*x=(lambda)*B*x,  A*Bx=(lambda)*x,  or B*A*x=(lambda)*x.  Here A and B
  3949.      are assumed to be symmetric and B is also
  3950.  
  3951.      DSYRFS improves the computed solution to a system of linear equations
  3952.      when the coefficient matrix is symmetric indefinite, and provides error
  3953.      bounds and backward error estimates for the solution.
  3954.  
  3955.  
  3956.  
  3957.                                                                        PPPPaaaaggggeeee 66660000
  3958.  
  3959.  
  3960.  
  3961.  
  3962.  
  3963.  
  3964. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  3965.  
  3966.  
  3967.  
  3968.      DSYSV computes the solution to a real system of linear equations
  3969.         A * X = B, where A is an N-by-N symmetric matrix and X and B are N-
  3970.      by-NRHS matrices.
  3971.  
  3972.      DSYSVX uses the diagonal pivoting factorization to compute the solution
  3973.      to a real system of linear equations A * X = B, where A is an N-by-N
  3974.      symmetric matrix and X and B are N-by-NRHS matrices.
  3975.  
  3976.      DSYTD2 reduces a real symmetric matrix A to symmetric tridiagonal form T
  3977.      by an orthogonal similarity transformation: Q' * A * Q = T.
  3978.  
  3979.      DSYTF2 computes the factorization of a real symmetric matrix A using the
  3980.      Bunch-Kaufman diagonal pivoting method:
  3981.  
  3982.         A = U*D*U'  or  A = L*D*L'
  3983.  
  3984.      DSYTRD reduces a real symmetric matrix A to real symmetric tridiagonal
  3985.      form T by an orthogonal similarity transformation:  Q**T * A * Q = T.
  3986.  
  3987.      DSYTRF computes the factorization of a real symmetric matrix A using the
  3988.      Bunch-Kaufman diagonal pivoting method.  The form of the factorization is
  3989.  
  3990.      DSYTRI computes the inverse of a real symmetric indefinite matrix A using
  3991.      the factorization A = U*D*U**T or A = L*D*L**T computed by DSYTRF.
  3992.  
  3993.      DSYTRS solves a system of linear equations A*X = B with a real symmetric
  3994.      matrix A using the factorization A = U*D*U**T or A = L*D*L**T computed by
  3995.      DSYTRF.
  3996.  
  3997.      DTBCON estimates the reciprocal of the condition number of a triangular
  3998.      band matrix A, in either the 1-norm or the infinity-norm.
  3999.  
  4000.      DTBRFS provides error bounds and backward error estimates for the
  4001.      solution to a system of linear equations with a triangular band
  4002.      coefficient matrix.
  4003.  
  4004.      DTBTRS solves a triangular system of the form
  4005.  
  4006.      where A is a triangular band matrix of order N, and B is an N-by NRHS
  4007.      matrix.  A check is made to verify that A is nonsingular.
  4008.  
  4009.      DTGEVC computes selected left and/or right generalized eigenvectors of a
  4010.      pair of real upper triangular matrices (A,B).  The j-th generalized left
  4011.      and right eigenvectors are  y  and  x, resp., such that:
  4012.  
  4013.      DTGSJA computes the generalized singular value decomposition (GSVD) of
  4014.      two real upper ``triangular (or trapezoidal)'' matrices A and B.
  4015.  
  4016.      DTPCON estimates the reciprocal of the condition number of a packed
  4017.      triangular matrix A, in either the 1-norm or the infinity-norm.
  4018.  
  4019.      DTPRFS provides error bounds and backward error estimates for the
  4020.  
  4021.  
  4022.  
  4023.                                                                        PPPPaaaaggggeeee 66661111
  4024.  
  4025.  
  4026.  
  4027.  
  4028.  
  4029.  
  4030. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  4031.  
  4032.  
  4033.  
  4034.      solution to a system of linear equations with a triangular packed
  4035.      coefficient matrix.
  4036.  
  4037.      DTPTRI computes the inverse of a real upper or lower triangular matrix A
  4038.      stored in packed format.
  4039.  
  4040.      DTPTRS solves a triangular system of the form
  4041.  
  4042.      where A is a triangular matrix of order N stored in packed format, and B
  4043.      is an N-by-NRHS matrix.  A check is made to verify that A is nonsingular.
  4044.  
  4045.      DTRCON estimates the reciprocal of the condition number of a triangular
  4046.      matrix A, in either the 1-norm or the infinity-norm.
  4047.  
  4048.      DTREVC computes all or some right and/or left eigenvectors of a real
  4049.      upper quasi-triangular matrix T.
  4050.  
  4051.      DTREXC reorders the real Schur factorization of a real matrix A =
  4052.      Q*T*Q**T, so that the diagonal block of T with row index IFST is moved to
  4053.      row ILST.
  4054.  
  4055.      DTRRFS provides error bounds and backward error estimates for the
  4056.      solution to a system of linear equations with a triangular coefficient
  4057.      matrix.
  4058.  
  4059.      DTRSEN reorders the real Schur factorization of a real matrix A =
  4060.      Q*T*Q**T, so that a selected cluster of eigenvalues appears in the
  4061.      leading diagonal blocks of the upper quasi-triangular matrix T, and the
  4062.      leading columns of Q form an orthonormal basis of the corresponding right
  4063.      invariant subspace.
  4064.  
  4065.      DTRSNA estimates reciprocal condition numbers for specified eigenvalues
  4066.      and/or right eigenvectors of a real upper quasi-triangular matrix T (or
  4067.      of any matrix Q*T*Q**T with Q orthogonal).
  4068.  
  4069.      DTRSYL solves the real Sylvester matrix equation:
  4070.  
  4071.         op(A)*X + X*op(B) = scale*C or
  4072.  
  4073.      DTRTI2 computes the inverse of a real upper or lower triangular matrix.
  4074.  
  4075.      DTRTRI computes the inverse of a real upper or lower triangular matrix A.
  4076.  
  4077.      DTRTRS solves a triangular system of the form
  4078.  
  4079.      where A is a triangular matrix of order N, and B is an N-by-NRHS matrix.
  4080.      A check is made to verify that A is nonsingular.
  4081.  
  4082.      DTZRQF reduces the M-by-N ( M<=N ) real upper trapezoidal matrix A to
  4083.      upper triangular form by means of orthogonal transformations.
  4084.  
  4085.      DZSUM1 takes the sum of the absolute values of a complex vector and
  4086.  
  4087.  
  4088.  
  4089.                                                                        PPPPaaaaggggeeee 66662222
  4090.  
  4091.  
  4092.  
  4093.  
  4094.  
  4095.  
  4096. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  4097.  
  4098.  
  4099.  
  4100.      returns a double precision result.
  4101.  
  4102.      ICMAX1 finds the index of the element whose real part has maximum
  4103.      absolute value.
  4104.  
  4105.      ILAENV is called from the LAPACK routines to choose problem-dependent
  4106.      parameters for the local environment.  See ISPEC for a description of the
  4107.      parameters.
  4108.  
  4109.      LSAME returns .TRUE. if CA is the same letter as CB regardless of case.
  4110.  
  4111.      LSAMEN  tests if the first N letters of CA are the same as the first N
  4112.      letters of CB, regardless of case.  LSAMEN returns .TRUE. if CA and CB
  4113.      are equivalent except for case and .FALSE. otherwise.  LSAMEN also
  4114.      returns .FALSE. if LEN( CA ) or LEN( CB ) is less than N.
  4115.  
  4116.      SBDSQR computes the singular value decomposition (SVD) of a real N-by-N
  4117.      (upper or lower) bidiagonal matrix B:  B = Q * S * P' (P' denotes the
  4118.      transpose of P), where S is a diagonal matrix with non-negative diagonal
  4119.      elements (the singular values of B), and Q and P are orthogonal matrices.
  4120.  
  4121.      SCSUM1 takes the sum of the absolute values of a complex vector and
  4122.      returns a single precision result.
  4123.  
  4124.      SGBCON estimates the reciprocal of the condition number of a real general
  4125.      band matrix A, in either the 1-norm or the infinity-norm, using the LU
  4126.      factorization computed by SGBTRF.
  4127.  
  4128.      SGBEQU computes row and column scalings intended to equilibrate an M by N
  4129.      band matrix A and reduce its condition number.  R returns the row scale
  4130.      factors and C the column scale factors, chosen to try to make the largest
  4131.      element in each row and column of the matrix B with elements
  4132.      B(i,j)=R(i)*A(i,j)*C(j) have absolute value 1.
  4133.  
  4134.      SGBRFS improves the computed solution to a system of linear equations
  4135.      when the coefficient matrix is banded, and provides error bounds and
  4136.      backward error estimates for the solution.
  4137.  
  4138.      SGBSV computes the solution to a real system of linear equations A * X =
  4139.      B, where A is a band matrix of order N with KL subdiagonals and KU
  4140.      superdiagonals, and X and B are N-by-NRHS matrices.
  4141.  
  4142.      SGBSVX uses the LU factorization to compute the solution to a real system
  4143.      of linear equations A * X = B, A**T * X = B, or A**H * X = B, where A is
  4144.      a band matrix of order N with KL subdiagonals and KU superdiagonals, and
  4145.      X and B are N-by-NRHS matrices.
  4146.  
  4147.      SGBTF2 computes an LU factorization of a real m-by-n band matrix A using
  4148.      partial pivoting with row interchanges.
  4149.  
  4150.      SGBTRF computes an LU factorization of a real m-by-n band matrix A using
  4151.      partial pivoting with row interchanges.
  4152.  
  4153.  
  4154.  
  4155.                                                                        PPPPaaaaggggeeee 66663333
  4156.  
  4157.  
  4158.  
  4159.  
  4160.  
  4161.  
  4162. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  4163.  
  4164.  
  4165.  
  4166.      SGBTRS solves a system of linear equations
  4167.         A * X = B  or  A' * X = B with a general band matrix A using the LU
  4168.      factorization computed by SGBTRF.
  4169.  
  4170.      SGEBAK forms the right or left eigenvectors of a real general matrix by
  4171.      backward transformation on the computed eigenvectors of the balanced
  4172.      matrix output by SGEBAL.
  4173.  
  4174.      SGEBAL balances a general real matrix A.  This involves, first, permuting
  4175.      A by a similarity transformation to isolate eigenvalues in the first 1 to
  4176.      ILO-1 and last IHI+1 to N elements on the diagonal; and second, applying
  4177.      a diagonal similarity transformation to rows and columns ILO to IHI to
  4178.      make the rows and columns as close in norm as possible.  Both steps are
  4179.      optional.
  4180.  
  4181.      SGEBD2 reduces a real general m by n matrix A to upper or lower
  4182.      bidiagonal form B by an orthogonal transformation: Q' * A * P = B.
  4183.  
  4184.      SGEBRD reduces a general real M-by-N matrix A to upper or lower
  4185.      bidiagonal form B by an orthogonal transformation: Q**T * A * P = B.
  4186.  
  4187.      SGECON estimates the reciprocal of the condition number of a general real
  4188.      matrix A, in either the 1-norm or the infinity-norm, using the LU
  4189.      factorization computed by SGETRF.
  4190.  
  4191.      SGEEQU computes row and column scalings intended to equilibrate an M-by-N
  4192.      matrix A and reduce its condition number.  R returns the row scale
  4193.      factors and C the column scale factors, chosen to try to make the largest
  4194.      entry in each row and column of the matrix B with elements
  4195.      B(i,j)=R(i)*A(i,j)*C(j) have absolute value 1.
  4196.  
  4197.      SGEES computes for an N-by-N real nonsymmetric matrix A, the eigenvalues,
  4198.      the real Schur form T, and, optionally, the matrix of Schur vectors Z.
  4199.      This gives the Schur factorization A = Z*T*(Z**T).
  4200.  
  4201.      SGEESX computes for an N-by-N real nonsymmetric matrix A, the
  4202.      eigenvalues, the real Schur form T, and, optionally, the matrix of Schur
  4203.      vectors Z.  This gives the Schur factorization A = Z*T*(Z**T).
  4204.  
  4205.      SGEEV computes for an N-by-N real nonsymmetric matrix A, the eigenvalues
  4206.      and, optionally, the left and/or right eigenvectors.
  4207.  
  4208.      SGEEVX computes for an N-by-N real nonsymmetric matrix A, the eigenvalues
  4209.      and, optionally, the left and/or right eigenvectors.
  4210.  
  4211.      For a pair of N-by-N real nonsymmetric matrices A, B:
  4212.  
  4213.         compute the generalized eigenvalues (alphar +/- alphai*i, beta)
  4214.         compute the real Schur form (A,B)
  4215.  
  4216.      For a pair of N-by-N real nonsymmetric matrices A, B:
  4217.  
  4218.  
  4219.  
  4220.  
  4221.                                                                        PPPPaaaaggggeeee 66664444
  4222.  
  4223.  
  4224.  
  4225.  
  4226.  
  4227.  
  4228. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  4229.  
  4230.  
  4231.  
  4232.         compute the generalized eigenvalues (alphar +/- alphai*i, beta)
  4233.         compute the left and/or right generalized eigenvectors
  4234.                 (VL and VR)
  4235.  
  4236.      SGEHD2 reduces a real general matrix A to upper Hessenberg form H by an
  4237.      orthogonal similarity transformation:  Q' * A * Q = H .
  4238.  
  4239.      SGEHRD reduces a real general matrix A to upper Hessenberg form H by an
  4240.      orthogonal similarity transformation:  Q' * A * Q = H .
  4241.  
  4242.      SGELQ2 computes an LQ factorization of a real m by n matrix A:  A = L *
  4243.      Q.
  4244.  
  4245.      SGELQF computes an LQ factorization of a real M-by-N matrix A:  A = L *
  4246.      Q.
  4247.  
  4248.      SGELS solves overdetermined or underdetermined real linear systems
  4249.      involving an M-by-N matrix A, or its transpose, using a QR or LQ
  4250.      factorization of A.  It is assumed that A has full rank.
  4251.  
  4252.      SGELSS computes the minimum norm solution to a real linear least squares
  4253.      problem:
  4254.  
  4255.      Minimize 2-norm(| b - A*x |).
  4256.  
  4257.      SGELSX computes the minimum-norm solution to a real linear least squares
  4258.      problem:
  4259.          minimize || A * X - B ||
  4260.  
  4261.      SGEQL2 computes a QL factorization of a real m by n matrix A:  A = Q * L.
  4262.  
  4263.      SGEQLF computes a QL factorization of a real M-by-N matrix A:  A = Q * L.
  4264.  
  4265.      SGEQPF computes a QR factorization with column pivoting of a real M-by-N
  4266.      matrix A: A*P = Q*R.
  4267.  
  4268.      SGEQR2 computes a QR factorization of a real m by n matrix A:  A = Q * R.
  4269.  
  4270.      SGEQRF computes a QR factorization of a real M-by-N matrix A:  A = Q * R.
  4271.  
  4272.      SGERFS improves the computed solution to a system of linear equations and
  4273.      provides error bounds and backward error estimates for the solution.
  4274.  
  4275.      SGERQ2 computes an RQ factorization of a real m by n matrix A:  A = R *
  4276.      Q.
  4277.  
  4278.      SGERQF computes an RQ factorization of a real M-by-N matrix A:  A = R *
  4279.      Q.
  4280.  
  4281.      SGESV computes the solution to a real system of linear equations
  4282.         A * X = B, where A is an N-by-N matrix and X and B are N-by-NRHS
  4283.      matrices.
  4284.  
  4285.  
  4286.  
  4287.                                                                        PPPPaaaaggggeeee 66665555
  4288.  
  4289.  
  4290.  
  4291.  
  4292.  
  4293.  
  4294. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  4295.  
  4296.  
  4297.  
  4298.      SGESVD computes the singular value decomposition (SVD) of a real M-by-N
  4299.      matrix A, optionally computing the left and/or right singular vectors.
  4300.      The SVD is written
  4301.  
  4302.           A = U * SIGMA * transpose(V)
  4303.  
  4304.      SGESVX uses the LU factorization to compute the solution to a real system
  4305.      of linear equations
  4306.         A * X = B, where A is an N-by-N matrix and X and B are N-by-NRHS
  4307.      matrices.
  4308.  
  4309.      SGETF2 computes an LU factorization of a general m-by-n matrix A using
  4310.      partial pivoting with row interchanges.
  4311.  
  4312.      SGETRF computes an LU factorization of a general M-by-N matrix A using
  4313.      partial pivoting with row interchanges.
  4314.  
  4315.      SGETRI computes the inverse of a matrix using the LU factorization
  4316.      computed by SGETRF.
  4317.  
  4318.      SGETRS solves a system of linear equations
  4319.         A * X = B  or  A' * X = B with a general N-by-N matrix A using the LU
  4320.      factorization computed by SGETRF.
  4321.  
  4322.      SGGBAK forms the right or left eigenvectors of the generalized eigenvalue
  4323.      problem by backward transformation on the computed eigenvectors of the
  4324.      balanced matrix output by SGGBAL.
  4325.  
  4326.      SGGBAL balances a pair of general real matrices (A,B) for the generalized
  4327.      eigenvalue problem A*X = lambda*B*X.  This involves, first, permuting A
  4328.      and B by similarity transformations to isolate eigenvalues in the first 1
  4329.      to ILO-1 and last IHI+1 to N elements on the diagonal; and second,
  4330.      applying a diagonal similarity
  4331.  
  4332.      SGGGLM solves a generalized linear regression model (GLM) problem:
  4333.  
  4334.              minimize y'*y     subject to    d = A*x + B*y
  4335.  
  4336.      SGGHRD reduces a pair of real matrices (A,B) to generalized upper
  4337.      Hessenberg form using orthogonal similarity transformations, where A is a
  4338.      (generally non-symmetric) square matrix and B is upper triangular.  More
  4339.      precisely, SGGHRD simultaneously decomposes  A into  Q H Z' and  B  into
  4340.      Q T Z' , where H is upper Hessenberg, T is upper triangular, Q and Z are
  4341.      orthogonal, and ' means transpose.
  4342.  
  4343.      SGGLSE solves the linear equality constrained least squares (LSE)
  4344.      problem:
  4345.  
  4346.              minimize || A*x - c ||_2   subject to B*x = d
  4347.  
  4348.      SGGQRF computes a generalized QR factorization of an N-by-M matrix A and
  4349.      an N-by-P matrix B:
  4350.  
  4351.  
  4352.  
  4353.                                                                        PPPPaaaaggggeeee 66666666
  4354.  
  4355.  
  4356.  
  4357.  
  4358.  
  4359.  
  4360. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  4361.  
  4362.  
  4363.  
  4364.                  A = Q*R,        B = Q*T*Z,
  4365.  
  4366.      SGGRQF computes a generalized RQ factorization of an M-by-N matrix A and
  4367.      a P-by-N matrix B:
  4368.  
  4369.                  A = R*Q,        B = Z*T*Q,
  4370.  
  4371.      SGGSVD computes the generalized singular value decomposition (GSVD) of
  4372.      the M-by-N matrix A and P-by-N matrix B:
  4373.  
  4374.          U'*A*Q = D1*( 0 R ),    V'*B*Q = D2*( 0 R )               (1)
  4375.  
  4376.      where U, V and Q are orthogonal matrices, and Z' is the transpose of Z.
  4377.      Let K+L = the numerical effective rank of the matrix (A',B')', then R is
  4378.      a K+L-by-K+L nonsingular upper tridiagonal matrix, D1 and D2 are
  4379.      "diagonal" matrices, and of the following structures, respectively:
  4380.  
  4381.      SGGSVP computes orthogonal matrices U, V and Q such that A23 is upper
  4382.      trapezoidal.  K+L = the effective rank of (M+P)-by-N matrix (A',B')'.  Z'
  4383.      denotes the transpose of Z.
  4384.  
  4385.      SGTCON estimates the reciprocal of the condition number of a real
  4386.      tridiagonal matrix A using the LU factorization as computed by SGTTRF.
  4387.  
  4388.      SGTRFS improves the computed solution to a system of linear equations
  4389.      when the coefficient matrix is tridiagonal, and provides error bounds and
  4390.      backward error estimates for the solution.
  4391.  
  4392.      SGTSV  solves the equation
  4393.  
  4394.      where A is an N-by-N tridiagonal matrix, by Gaussian elimination with
  4395.      partial pivoting.
  4396.  
  4397.      SGTSVX uses the LU factorization to compute the solution to a real system
  4398.      of linear equations A * X = B or A**T * X = B, where A is a tridiagonal
  4399.      matrix of order N and X and B are N-by-NRHS matrices.
  4400.  
  4401.      SGTTRF computes an LU factorization of a real tridiagonal matrix A using
  4402.      elimination with partial pivoting and row interchanges.
  4403.  
  4404.      SGTTRS solves one of the systems of equations
  4405.         A*X = B  or  A'*X = B, with a tridiagonal matrix A using the LU
  4406.      factorization computed by SGTTRF.
  4407.  
  4408.      SHGEQZ implements a single-/double-shift version of the QZ method for
  4409.      finding the generalized eigenvalues B is upper triangular, and A is block
  4410.      upper triangular, where the diagonal blocks are either 1x1 or 2x2, the
  4411.      2x2 blocks having complex generalized eigenvalues (see the description of
  4412.      the argument JOB.)
  4413.  
  4414.      If JOB='S', then the pair (A,B) is simultaneously reduced to Schur form
  4415.      using one orthogonal tranformation (usually called Q) on the left and
  4416.  
  4417.  
  4418.  
  4419.                                                                        PPPPaaaaggggeeee 66667777
  4420.  
  4421.  
  4422.  
  4423.  
  4424.  
  4425.  
  4426. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  4427.  
  4428.  
  4429.  
  4430.      another (usually called Z) on the right.  The 2x2 upper-triangular
  4431.      diagonal blocks of B corresponding to 2x2 blocks of A will be reduced to
  4432.      positive diagonal matrices.  (I.e., if A(j+1,j) is non-zero, then
  4433.      B(j+1,j)=B(j,j+1)=0 and B(j,j) and B(j+1,j+1) will be positive.)
  4434.  
  4435.      SHSEIN uses inverse iteration to find specified right and/or left
  4436.      eigenvectors of a real upper Hessenberg matrix H.
  4437.  
  4438.      SHSEQR computes the eigenvalues of a real upper Hessenberg matrix H and,
  4439.      optionally, the matrices T and Z from the Schur decomposition H = Z T
  4440.      Z**T, where T is an upper quasi-triangular matrix (the Schur form), and Z
  4441.      is the orthogonal matrix of Schur vectors.
  4442.  
  4443.      SLABAD takes as input the values computed by SLAMCH for underflow and
  4444.      overflow, and returns the square root of each of these values if the log
  4445.      of LARGE is sufficiently large.  This subroutine is intended to identify
  4446.      machines with a large exponent range, such as the Crays, and redefine the
  4447.      underflow and overflow limits to be the square roots of the values
  4448.      computed by SLAMCH.  This subroutine is needed because SLAMCH does not
  4449.      compensate for poor arithmetic in the upper half of the exponent range,
  4450.      as is found on a Cray.
  4451.  
  4452.      SLABRD reduces the first NB rows and columns of a real general m by n
  4453.      matrix A to upper or lower bidiagonal form by an orthogonal
  4454.      transformation Q' * A * P, and returns the matrices X and Y which are
  4455.      needed to apply the transformation to the unreduced part of A.
  4456.  
  4457.      SLACON estimates the 1-norm of a square, real matrix A.  Reverse
  4458.      communication is used for evaluating matrix-vector products.
  4459.  
  4460.      SLACPY copies all or part of a two-dimensional matrix A to another matrix
  4461.      B.
  4462.  
  4463.      SLADIV performs complex division in  real arithmetic in D. Knuth, The art
  4464.      of Computer Programming, Vol.2, p.195
  4465.  
  4466.  
  4467.      SLAE2  computes the eigenvalues of a 2-by-2 symmetric matrix
  4468.         [  A   B  ]
  4469.         [  B   C  ].  On return, RT1 is the eigenvalue of larger absolute
  4470.      value, and RT2 is the eigenvalue of smaller absolute value.
  4471.  
  4472.      SLAEBZ contains the iteration loops which compute and use the function
  4473.      N(w), which is the count of eigenvalues of a symmetric tridiagonal matrix
  4474.      T less than or equal to its argument  w.  It performs a choice of two
  4475.      types of loops:
  4476.  
  4477.      SLAEIN uses inverse iteration to find a right or left eigenvector
  4478.      corresponding to the eigenvalue (WR,WI) of a real upper Hessenberg matrix
  4479.      H.
  4480.  
  4481.      SLAEV2 computes the eigendecomposition of a 2-by-2 symmetric matrix
  4482.  
  4483.  
  4484.  
  4485.                                                                        PPPPaaaaggggeeee 66668888
  4486.  
  4487.  
  4488.  
  4489.  
  4490.  
  4491.  
  4492. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  4493.  
  4494.  
  4495.  
  4496.         [  A   B  ]
  4497.         [  B   C  ].  On return, RT1 is the eigenvalue of larger absolute
  4498.      value, RT2 is the eigenvalue of smaller absolute value, and (CS1,SN1) is
  4499.      the unit right eigenvector for RT1, giving the decomposition
  4500.  
  4501.      SLAEXC swaps adjacent diagonal blocks T11 and T22 of order 1 or 2 in an
  4502.      upper quasi-triangular matrix T by an orthogonal similarity
  4503.      transformation.
  4504.  
  4505.      SLAG2 computes the eigenvalues of a 2 x 2 generalized eigenvalue problem
  4506.      A - w B, with scaling as necessary to avoid over-/underflow.
  4507.  
  4508.      SLAGS2 computes 2-by-2 orthogonal matrices U, V and Q, such that if (
  4509.      UPPER ) then
  4510.  
  4511.  
  4512.  
  4513.      SLAGTF factorizes the matrix (T - lambda*I), where T is an n by n
  4514.      tridiagonal matrix and lambda is a scalar, as
  4515.  
  4516.      where P is a permutation matrix, L is a unit lower tridiagonal matrix
  4517.      with at most one non-zero sub-diagonal elements per column and U is an
  4518.      upper triangular matrix with at most two non-zero super-diagonal elements
  4519.      per column.
  4520.  
  4521.      SLAGTM performs a matrix-vector product of the form
  4522.  
  4523.  
  4524.      SLAGTS may be used to solve one of the systems of equations
  4525.  
  4526.      where T is an n by n tridiagonal matrix, for x, following the
  4527.      factorization of (T - lambda*I) as
  4528.  
  4529.      SLAHQR is an auxiliary routine called by SHSEQR to update the eigenvalues
  4530.      and Schur decomposition already computed by SHSEQR, by dealing with the
  4531.      Hessenberg submatrix in rows and columns ILO to IHI.
  4532.  
  4533.      SLAHRD reduces the first NB columns of a real general n-by-(n-k+1) matrix
  4534.      A so that elements below the k-th subdiagonal are zero. The reduction is
  4535.      performed by an orthogonal similarity transformation Q' * A * Q. The
  4536.      routine returns the matrices V and T which determine Q as a block
  4537.      reflector I - V*T*V', and also the matrix Y = A * V * T.
  4538.  
  4539.      SLAIC1 applies one step of incremental condition estimation in its
  4540.      simplest version:
  4541.  
  4542.      Let x, twonorm(x) = 1, be an approximate singular vector of an j-by-j
  4543.      lower triangular matrix L, such that
  4544.  
  4545.      SLALN2 solves a system of the form  (ca A - w D ) X = s B or (ca A' - w
  4546.      D) X = s B   with possible scaling ("s") and perturbation of A.  (A'
  4547.      means A-transpose.)
  4548.  
  4549.  
  4550.  
  4551.                                                                        PPPPaaaaggggeeee 66669999
  4552.  
  4553.  
  4554.  
  4555.  
  4556.  
  4557.  
  4558. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  4559.  
  4560.  
  4561.  
  4562.      A is an NA x NA real matrix, ca is a real scalar, D is an NA x NA real
  4563.      diagonal matrix, w is a real or complex value, and X and B are NA x 1
  4564.      matrices -- real if w is real, complex if w is complex.  NA may be 1 or
  4565.      2.
  4566.  
  4567.      SLAMCH determines single precision machine parameters.
  4568.  
  4569.      SLANGB  returns the value of the one norm,  or the Frobenius norm, or the
  4570.      infinity norm,  or the element of  largest absolute value  of an n by n
  4571.      band matrix  A,  with kl sub-diagonals and ku super-diagonals.
  4572.  
  4573.      SLANGE  returns the value of the one norm,  or the Frobenius norm, or the
  4574.      infinity norm,  or the  element of  largest absolute value  of a real
  4575.      matrix A.
  4576.  
  4577.      SLANGT  returns the value of the one norm,  or the Frobenius norm, or the
  4578.      infinity norm,  or the  element of  largest absolute value  of a real
  4579.      tridiagonal matrix A.
  4580.  
  4581.      SLANHS  returns the value of the one norm,  or the Frobenius norm, or the
  4582.      infinity norm,  or the  element of  largest absolute value  of a
  4583.      Hessenberg matrix A.
  4584.  
  4585.      SLANSB  returns the value of the one norm,  or the Frobenius norm, or the
  4586.      infinity norm,  or the element of  largest absolute value  of an n by n
  4587.      symmetric band matrix A,  with k super-diagonals.
  4588.  
  4589.      SLANSP  returns the value of the one norm,  or the Frobenius norm, or the
  4590.      infinity norm,  or the  element of  largest absolute value  of a real
  4591.      symmetric matrix A,  supplied in packed form.
  4592.  
  4593.      SLANST  returns the value of the one norm,  or the Frobenius norm, or the
  4594.      infinity norm,  or the  element of  largest absolute value  of a real
  4595.      symmetric tridiagonal matrix A.
  4596.  
  4597.      SLANSY  returns the value of the one norm,  or the Frobenius norm, or the
  4598.      infinity norm,  or the  element of  largest absolute value  of a real
  4599.      symmetric matrix A.
  4600.  
  4601.      SLANTB  returns the value of the one norm,  or the Frobenius norm, or the
  4602.      infinity norm,  or the element of  largest absolute value  of an n by n
  4603.      triangular band matrix A,  with ( k + 1 ) diagonals.
  4604.  
  4605.      SLANTP  returns the value of the one norm,  or the Frobenius norm, or the
  4606.      infinity norm,  or the  element of  largest absolute value  of a
  4607.      triangular matrix A, supplied in packed form.
  4608.  
  4609.      SLANTR  returns the value of the one norm,  or the Frobenius norm, or the
  4610.      infinity norm,  or the  element of  largest absolute value  of a
  4611.      trapezoidal or triangular matrix A.
  4612.  
  4613.      SLANV2 computes the Schur factorization of a real 2-by-2 nonsymmetric
  4614.  
  4615.  
  4616.  
  4617.                                                                        PPPPaaaaggggeeee 77770000
  4618.  
  4619.  
  4620.  
  4621.  
  4622.  
  4623.  
  4624. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  4625.  
  4626.  
  4627.  
  4628.      matrix in standard form:
  4629.  
  4630.           [ A  B ] = [ CS -SN ] [ AA  BB ] [ CS  SN ]
  4631.  
  4632.      Given two column vectors X and Y, let
  4633.  
  4634.      The subroutine first computes the QR factorization of A = Q*R, and then
  4635.      computes the SVD of the 2-by-2 upper triangular matrix R.  The smaller
  4636.      singular value of R is returned in SSMIN, which is used as the
  4637.      measurement of the linear dependency of the vectors X and Y.
  4638.  
  4639.      SLAPMT rearranges the columns of the M by N matrix X as specified by the
  4640.      permutation K(1),K(2),...,K(N) of the integers 1,...,N.  If FORWRD =
  4641.      .TRUE.,  forward permutation:
  4642.  
  4643.      SLAPY2 returns sqrt(x**2+y**2), taking care not to cause unnecessary
  4644.      overflow.
  4645.  
  4646.      SLAPY3 returns sqrt(x**2+y**2+z**2), taking care not to cause unnecessary
  4647.      overflow.
  4648.  
  4649.      SLAQGB equilibrates a general M by N band matrix A with KL subdiagonals
  4650.      and KU superdiagonals using the row and scaling factors in the vectors R
  4651.      and C.
  4652.  
  4653.      SLAQGE equilibrates a general M by N matrix A using the row and scaling
  4654.      factors in the vectors R and C.
  4655.  
  4656.      SLAQSB equilibrates a symmetric band matrix A using the scaling factors
  4657.      in the vector S.
  4658.  
  4659.      SLAQSP equilibrates a symmetric matrix A using the scaling factors in the
  4660.      vector S.
  4661.  
  4662.      SLAQSY equilibrates a symmetric matrix A using the scaling factors in the
  4663.      vector S.
  4664.  
  4665.      SLAQTR solves the real quasi-triangular system
  4666.  
  4667.      or the complex quasi-triangular systems
  4668.  
  4669.      SLAR2V applies a vector of real plane rotations from both sides to a
  4670.      sequence of 2-by-2 real symmetric matrices, defined by the elements of
  4671.      the vectors x, y and z. For i = 1,2,...,n
  4672.  
  4673.         ( x(i)  z(i) ) := (  c(i)  s(i) ) ( x(i)  z(i) ) ( c(i) -s(i) )
  4674.         ( z(i)  y(i) )    ( -s(i)  c(i) ) ( z(i)  y(i) ) ( s(i)  c(i) )
  4675.  
  4676.  
  4677.      SLARF applies a real elementary reflector H to a real m by n matrix C,
  4678.      from either the left or the right. H is represented in the form
  4679.  
  4680.  
  4681.  
  4682.  
  4683.                                                                        PPPPaaaaggggeeee 77771111
  4684.  
  4685.  
  4686.  
  4687.  
  4688.  
  4689.  
  4690. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  4691.  
  4692.  
  4693.  
  4694.            H = I - tau * v * v'
  4695.  
  4696.      SLARFB applies a real block reflector H or its transpose H' to a real m
  4697.      by n matrix C, from either the left or the right.
  4698.  
  4699.      SLARFG generates a real elementary reflector H of order n, such that
  4700.                (   x   )   (   0  )
  4701.  
  4702.      SLARFT forms the triangular factor T of a real block reflector H of order
  4703.      n, which is defined as a product of k elementary reflectors.
  4704.  
  4705.      SLARFX applies a real elementary reflector H to a real m by n matrix C,
  4706.      from either the left or the right. H is represented in the form
  4707.  
  4708.      SLARGV generates a vector of real plane rotations, determined by elements
  4709.      of the real vectors x and y. For i = 1,2,...,n
  4710.  
  4711.         (  c(i)  s(i) ) ( x(i) ) = ( a(i) )
  4712.  
  4713.      SLARNV returns a vector of n random real numbers from a uniform or normal
  4714.      distribution.
  4715.  
  4716.      SLARTG generate a plane rotation so that
  4717.         [ -SN  CS  ]     [ G ]     [ 0 ]
  4718.  
  4719.      SLARTV applies a vector of real plane rotations to elements of the real
  4720.      vectors x and y. For i = 1,2,...,n
  4721.  
  4722.         ( x(i) ) := (  c(i)  s(i) ) ( x(i) )
  4723.  
  4724.      SLARUV returns a vector of n random real numbers from a uniform (0,1)
  4725.      distribution (n <= 128).
  4726.  
  4727.      SLAS2  computes the singular values of the 2-by-2 matrix
  4728.         [  F   G  ]
  4729.         [  0   H  ].  On return, SSMIN is the smaller singular value and SSMAX
  4730.      is the larger singular value.
  4731.  
  4732.      SLASCL multiplies the M by N real matrix A by the real scalar CTO/CFROM.
  4733.      This is done without over/underflow as long as the final result
  4734.      CTO*A(I,J)/CFROM does not over/underflow. TYPE specifies that A may be
  4735.      full, upper triangular, lower triangular, upper Hessenberg, or banded.
  4736.  
  4737.      SLASET initializes an m-by-n matrix A to BETA on the diagonal and ALPHA
  4738.      on the offdiagonals.
  4739.  
  4740.      SLASR   performs the transformation consisting of a sequence of plane
  4741.      rotations determined by the parameters PIVOT and DIRECT as follows ( z =
  4742.      m when SIDE = 'L' or 'l' and z = n when SIDE = 'R' or 'r' ):
  4743.  
  4744.      SLASSQ  returns the values  scl  and  smsq  such that
  4745.  
  4746.  
  4747.  
  4748.  
  4749.                                                                        PPPPaaaaggggeeee 77772222
  4750.  
  4751.  
  4752.  
  4753.  
  4754.  
  4755.  
  4756. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  4757.  
  4758.  
  4759.  
  4760.      where  x( i ) = X( 1 + ( i - 1 )*INCX ). The value of  sumsq  is assumed
  4761.      to be non-negative and  scl  returns the value
  4762.  
  4763.      SLASV2 computes the singular value decomposition of a 2-by-2 triangular
  4764.      matrix
  4765.         [  F   G  ]
  4766.         [  0   H  ].  On return, abs(SSMAX) is the larger singular value,
  4767.      abs(SSMIN) is the smaller singular value, and (CSL,SNL) and (CSR,SNR) are
  4768.      the left and right singular vectors for abs(SSMAX), giving the
  4769.      decomposition
  4770.  
  4771.         [ CSL  SNL ] [  F   G  ] [ CSR -SNR ]  =  [ SSMAX   0   ]
  4772.         [-SNL  CSL ] [  0   H  ] [ SNR  CSR ]     [  0    SSMIN ].
  4773.  
  4774.      SLASWP performs a series of row interchanges on the matrix A.  One row
  4775.      interchange is initiated for each of rows K1 through K2 of A.
  4776.  
  4777.      SLASY2 solves for the N1 by N2 matrix X, 1 <= N1,N2 <= 2, in
  4778.  
  4779.      where TL is N1 by N1, TR is N2 by N2, B is N1 by N2, and ISGN = 1 or -1.
  4780.      op(T) = T or T', where T' denotes the transpose of T.
  4781.  
  4782.      SLASYF computes a partial factorization of a real symmetric matrix A
  4783.      using the Bunch-Kaufman diagonal pivoting method. The partial
  4784.      factorization has the form:
  4785.  
  4786.      SLATBS solves one of the triangular systems are n-element vectors, and s
  4787.      is a scaling factor, usually less than or equal to 1, chosen so that the
  4788.      components of x will be less than the overflow threshold.  If the
  4789.      unscaled problem will not cause overflow, the Level 2 BLAS routine STBSV
  4790.      is called.  If the matrix A is singular (A(j,j) = 0 for some j), then s
  4791.      is set to 0 and a non-trivial solution to A*x = 0 is returned.
  4792.  
  4793.      SLATPS solves one of the triangular systems transpose of A, x and b are
  4794.      n-element vectors, and s is a scaling factor, usually less than or equal
  4795.      to 1, chosen so that the components of x will be less than the overflow
  4796.      threshold.  If the unscaled problem will not cause overflow, the Level 2
  4797.      BLAS routine STPSV is called. If the matrix A is singular (A(j,j) = 0 for
  4798.      some j), then s is set to 0 and a non-trivial solution to A*x = 0 is
  4799.      returned.
  4800.  
  4801.      SLATRD reduces NB rows and columns of a real symmetric matrix A to
  4802.      symmetric tridiagonal form by an orthogonal similarity transformation Q'
  4803.      * A * Q, and returns the matrices V and W which are needed to apply the
  4804.      transformation to the unreduced part of A.
  4805.  
  4806.      SLATRS solves one of the triangular systems triangular matrix, A' denotes
  4807.      the transpose of A, x and b are n-element vectors, and s is a scaling
  4808.      factor, usually less than or equal to 1, chosen so that the components of
  4809.      x will be less than the overflow threshold.  If the unscaled problem will
  4810.      not cause overflow, the Level 2 BLAS routine STRSV is called.  If the
  4811.      matrix A is singular (A(j,j) = 0 for some j), then s is set to 0 and a
  4812.  
  4813.  
  4814.  
  4815.                                                                        PPPPaaaaggggeeee 77773333
  4816.  
  4817.  
  4818.  
  4819.  
  4820.  
  4821.  
  4822. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  4823.  
  4824.  
  4825.  
  4826.      non-trivial solution to A*x = 0 is returned.
  4827.  
  4828.      SLATZM applies a Householder matrix generated by STZRQF to a matrix.
  4829.  
  4830.      SLAUU2 computes the product U * U' or L' * L, where the triangular factor
  4831.      U or L is stored in the upper or lower triangular part of the array A.
  4832.  
  4833.      SLAUUM computes the product U * U' or L' * L, where the triangular factor
  4834.      U or L is stored in the upper or lower triangular part of the array A.
  4835.  
  4836.      SLAZRO initializes a 2-D array A to BETA on the diagonal and ALPHA on the
  4837.      offdiagonals.
  4838.  
  4839.      SOPGTR generates a real orthogonal matrix Q which is defined as the
  4840.      product of n-1 elementary reflectors of order n, as returned by SSPTRD
  4841.      using packed storage:
  4842.  
  4843.      if UPLO = 'U', Q = H(n-1) . . . H(2) H(1),
  4844.  
  4845.      SOPMTR overwrites the general real M-by-N matrix C with TRANS = 'T':
  4846.      Q**T * C       C * Q**T
  4847.  
  4848.      SORG2L generates an m by n real matrix Q with orthonormal columns, which
  4849.      is defined as the last n columns of a product of k elementary reflectors
  4850.      of order m
  4851.  
  4852.      SORG2R generates an m by n real matrix Q with orthonormal columns, which
  4853.      is defined as the first n columns of a product of k elementary reflectors
  4854.      of order m
  4855.  
  4856.      SORGBR generates one of the matrices Q or P**T determined by SGEBRD when
  4857.      reducing a real matrix A to bidiagonal form: A = Q * B * P**T.  Q and
  4858.      P**T are defined as products of elementary reflectors H(i) or G(i)
  4859.      respectively.
  4860.  
  4861.      SORGHR generates a real orthogonal matrix Q which is defined as the
  4862.      product of IHI-ILO elementary reflectors of order N, as returned by
  4863.      SGEHRD:
  4864.  
  4865.      Q = H(ilo) H(ilo+1) . . . H(ihi-1).
  4866.  
  4867.      SORGL2 generates an m by n real matrix Q with orthonormal rows, which is
  4868.      defined as the first m rows of a product of k elementary reflectors of
  4869.      order n
  4870.  
  4871.      SORGLQ generates an M-by-N real matrix Q with orthonormal rows, which is
  4872.      defined as the first M rows of a product of K elementary reflectors of
  4873.      order N
  4874.  
  4875.      SORGQL generates an M-by-N real matrix Q with orthonormal columns, which
  4876.      is defined as the last N columns of a product of K elementary reflectors
  4877.      of order M
  4878.  
  4879.  
  4880.  
  4881.                                                                        PPPPaaaaggggeeee 77774444
  4882.  
  4883.  
  4884.  
  4885.  
  4886.  
  4887.  
  4888. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  4889.  
  4890.  
  4891.  
  4892.      SORGQR generates an M-by-N real matrix Q with orthonormal columns, which
  4893.      is defined as the first N columns of a product of K elementary reflectors
  4894.      of order M
  4895.  
  4896.      SORGR2 generates an m by n real matrix Q with orthonormal rows, which is
  4897.      defined as the last m rows of a product of k elementary reflectors of
  4898.      order n
  4899.  
  4900.      SORGRQ generates an M-by-N real matrix Q with orthonormal rows, which is
  4901.      defined as the last M rows of a product of K elementary reflectors of
  4902.      order N
  4903.  
  4904.      SORGTR generates a real orthogonal matrix Q which is defined as the
  4905.      product of n-1 elementary reflectors of order N, as returned by SSYTRD:
  4906.  
  4907.      if UPLO = 'U', Q = H(n-1) . . . H(2) H(1),
  4908.  
  4909.      SORM2L overwrites the general real m by n matrix C with
  4910.  
  4911.      where Q is a real orthogonal matrix defined as the product of k
  4912.      elementary reflectors
  4913.  
  4914.      SORM2R overwrites the general real m by n matrix C with
  4915.  
  4916.      where Q is a real orthogonal matrix defined as the product of k
  4917.      elementary reflectors
  4918.  
  4919.      If VECT = 'Q', SORMBR overwrites the general real M-by-N matrix C with
  4920.                      SIDE = 'L'     SIDE = 'R' TRANS = 'N':      Q * C
  4921.      C * Q TRANS = 'T':      Q**T * C       C * Q**T
  4922.  
  4923.      SORMHR overwrites the general real M-by-N matrix C with TRANS = 'T':
  4924.      Q**T * C       C * Q**T
  4925.  
  4926.      SORML2 overwrites the general real m by n matrix C with
  4927.  
  4928.      where Q is a real orthogonal matrix defined as the product of k
  4929.      elementary reflectors
  4930.  
  4931.      SORMLQ overwrites the general real M-by-N matrix C with TRANS = 'T':
  4932.      Q**T * C       C * Q**T
  4933.  
  4934.      SORMQL overwrites the general real M-by-N matrix C with TRANS = 'T':
  4935.      Q**T * C       C * Q**T
  4936.  
  4937.      SORMQR overwrites the general real M-by-N matrix C with TRANS = 'T':
  4938.      Q**T * C       C * Q**T
  4939.  
  4940.      SORMR2 overwrites the general real m by n matrix C with
  4941.  
  4942.      where Q is a real orthogonal matrix defined as the product of k
  4943.      elementary reflectors
  4944.  
  4945.  
  4946.  
  4947.                                                                        PPPPaaaaggggeeee 77775555
  4948.  
  4949.  
  4950.  
  4951.  
  4952.  
  4953.  
  4954. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  4955.  
  4956.  
  4957.  
  4958.      SORMRQ overwrites the general real M-by-N matrix C with TRANS = 'T':
  4959.      Q**T * C       C * Q**T
  4960.  
  4961.      SORMTR overwrites the general real M-by-N matrix C with TRANS = 'T':
  4962.      Q**T * C       C * Q**T
  4963.  
  4964.      SPBCON estimates the reciprocal of the condition number (in the 1-norm)
  4965.      of a real symmetric positive definite band matrix using the Cholesky
  4966.      factorization A = U**T*U or A = L*L**T computed by SPBTRF.
  4967.  
  4968.      SPBEQU computes row and column scalings intended to equilibrate a
  4969.      symmetric positive definite band matrix A and reduce its condition number
  4970.      (with respect to the two-norm).  S contains the scale factors, S(i) =
  4971.      1/sqrt(A(i,i)), chosen so that the scaled matrix B with elements B(i,j) =
  4972.      S(i)*A(i,j)*S(j) has ones on the diagonal.  This choice of S puts the
  4973.      condition number of B within a factor N of the smallest possible
  4974.      condition number over all possible diagonal scalings.
  4975.  
  4976.      SPBRFS improves the computed solution to a system of linear equations
  4977.      when the coefficient matrix is symmetric positive definite and banded,
  4978.      and provides error bounds and backward error estimates for the solution.
  4979.  
  4980.      SPBSV computes the solution to a real system of linear equations
  4981.         A * X = B, where A is an N-by-N symmetric positive definite band
  4982.      matrix and X and B are N-by-NRHS matrices.
  4983.  
  4984.      SPBSVX uses the Cholesky factorization A = U**T*U or A = L*L**T to
  4985.      compute the solution to a real system of linear equations
  4986.         A * X = B, where A is an N-by-N symmetric positive definite band
  4987.      matrix and X and B are N-by-NRHS matrices.
  4988.  
  4989.      SPBTF2 computes the Cholesky factorization of a real symmetric positive
  4990.      definite band matrix A.
  4991.  
  4992.      SPBTRF computes the Cholesky factorization of a real symmetric positive
  4993.      definite band matrix A.
  4994.  
  4995.      SPBTRS solves a system of linear equations A*X = B with a symmetric
  4996.      positive definite band matrix A using the Cholesky factorization A =
  4997.      U**T*U or A = L*L**T computed by SPBTRF.
  4998.  
  4999.      SPOCON estimates the reciprocal of the condition number (in the 1-norm)
  5000.      of a real symmetric positive definite matrix using the Cholesky
  5001.      factorization A = U**T*U or A = L*L**T computed by SPOTRF.
  5002.  
  5003.      SPOEQU computes row and column scalings intended to equilibrate a
  5004.      symmetric positive definite matrix A and reduce its condition number
  5005.      (with respect to the two-norm).  S contains the scale factors, S(i) =
  5006.      1/sqrt(A(i,i)), chosen so that the scaled matrix B with elements B(i,j) =
  5007.      S(i)*A(i,j)*S(j) has ones on the diagonal.  This choice of S puts the
  5008.      condition number of B within a factor N of the smallest possible
  5009.      condition number over all possible diagonal scalings.
  5010.  
  5011.  
  5012.  
  5013.                                                                        PPPPaaaaggggeeee 77776666
  5014.  
  5015.  
  5016.  
  5017.  
  5018.  
  5019.  
  5020. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  5021.  
  5022.  
  5023.  
  5024.      SPORFS improves the computed solution to a system of linear equations
  5025.      when the coefficient matrix is symmetric positive definite, and provides
  5026.      error bounds and backward error estimates for the solution.
  5027.  
  5028.      SPOSV computes the solution to a real system of linear equations
  5029.         A * X = B, where A is an N-by-N symmetric positive definite matrix and
  5030.      X and B are N-by-NRHS matrices.
  5031.  
  5032.      SPOSVX uses the Cholesky factorization A = U**T*U or A = L*L**T to
  5033.      compute the solution to a real system of linear equations
  5034.         A * X = B, where A is an N-by-N symmetric positive definite matrix and
  5035.      X and B are N-by-NRHS matrices.
  5036.  
  5037.      SPOTF2 computes the Cholesky factorization of a real symmetric positive
  5038.      definite matrix A.
  5039.  
  5040.      SPOTRF computes the Cholesky factorization of a real symmetric positive
  5041.      definite matrix A.
  5042.  
  5043.      SPOTRI computes the inverse of a real symmetric positive definite matrix
  5044.      A using the Cholesky factorization A = U**T*U or A = L*L**T computed by
  5045.      SPOTRF.
  5046.  
  5047.      SPOTRS solves a system of linear equations A*X = B with a symmetric
  5048.      positive definite matrix A using the Cholesky factorization A = U**T*U or
  5049.      A = L*L**T computed by SPOTRF.
  5050.  
  5051.      SPPCON estimates the reciprocal of the condition number (in the 1-norm)
  5052.      of a real symmetric positive definite packed matrix using the Cholesky
  5053.      factorization A = U**T*U or A = L*L**T computed by SPPTRF.
  5054.  
  5055.      SPPEQU computes row and column scalings intended to equilibrate a
  5056.      symmetric positive definite matrix A in packed storage and reduce its
  5057.      condition number (with respect to the two-norm).  S contains the scale
  5058.      factors, S(i)=1/sqrt(A(i,i)), chosen so that the scaled matrix B with
  5059.      elements B(i,j)=S(i)*A(i,j)*S(j) has ones on the diagonal.  This choice
  5060.      of S puts the condition number of B within a factor N of the smallest
  5061.      possible condition number over all possible diagonal scalings.
  5062.  
  5063.      SPPRFS improves the computed solution to a system of linear equations
  5064.      when the coefficient matrix is symmetric positive definite and packed,
  5065.      and provides error bounds and backward error estimates for the solution.
  5066.  
  5067.      SPPSV computes the solution to a real system of linear equations
  5068.         A * X = B, where A is an N-by-N symmetric positive definite matrix
  5069.      stored in packed format and X and B are N-by-NRHS matrices.
  5070.  
  5071.      SPPSVX uses the Cholesky factorization A = U**T*U or A = L*L**T to
  5072.      compute the solution to a real system of linear equations
  5073.         A * X = B, where A is an N-by-N symmetric positive definite matrix
  5074.      stored in packed format and X and B are N-by-NRHS matrices.
  5075.  
  5076.  
  5077.  
  5078.  
  5079.                                                                        PPPPaaaaggggeeee 77777777
  5080.  
  5081.  
  5082.  
  5083.  
  5084.  
  5085.  
  5086. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  5087.  
  5088.  
  5089.  
  5090.      SPPTRF computes the Cholesky factorization of a real symmetric positive
  5091.      definite matrix A stored in packed format.
  5092.  
  5093.      SPPTRI computes the inverse of a real symmetric positive definite matrix
  5094.      A using the Cholesky factorization A = U**T*U or A = L*L**T computed by
  5095.      SPPTRF.
  5096.  
  5097.      SPPTRS solves a system of linear equations A*X = B with a symmetric
  5098.      positive definite matrix A in packed storage using the Cholesky
  5099.      factorization A = U**T*U or A = L*L**T computed by SPPTRF.
  5100.  
  5101.      SPTCON computes the reciprocal of the condition number (in the 1-norm) of
  5102.      a real symmetric positive definite tridiagonal matrix using the
  5103.      factorization A = L*D*L**T or A = U**T*D*U computed by SPTTRF.
  5104.  
  5105.      SPTEQR computes all eigenvalues and, optionally, eigenvectors of a
  5106.      symmetric positive definite tridiagonal matrix by first factoring the
  5107.      matrix using SPTTRF, and then calling SBDSQR to compute the singular
  5108.      values of the bidiagonal factor.
  5109.  
  5110.      SPTRFS improves the computed solution to a system of linear equations
  5111.      when the coefficient matrix is symmetric positive definite and
  5112.      tridiagonal, and provides error bounds and backward error estimates for
  5113.      the solution.
  5114.  
  5115.      SPTSV computes the solution to a real system of linear equations A*X = B,
  5116.      where A is an N-by-N symmetric positive definite tridiagonal matrix, and
  5117.      X and B are N-by-NRHS matrices.
  5118.  
  5119.      SPTSVX uses the factorization A = L*D*L**T to compute the solution to a
  5120.      real system of linear equations A*X = B, where A is an N-by-N symmetric
  5121.      positive definite tridiagonal matrix and X and B are N-by-NRHS matrices.
  5122.  
  5123.      SPTTRF computes the factorization of a real symmetric positive definite
  5124.      tridiagonal matrix A.
  5125.  
  5126.      SPTTRS solves a system of linear equations A * X = B with a symmetric
  5127.      positive definite tridiagonal matrix A using the factorization A =
  5128.      L*D*L**T or A = U**T*D*U computed by SPTTRF.  (The two forms are
  5129.      equivalent if A is real.)
  5130.  
  5131.      SRSCL multiplies an n-element real vector x by the real scalar 1/a.  This
  5132.      is done without overflow or underflow as long as
  5133.  
  5134.      SSBEV computes all the eigenvalues and, optionally, eigenvectors of a
  5135.      real symmetric band matrix A.
  5136.  
  5137.      SSBEVX computes selected eigenvalues and, optionally, eigenvectors of a
  5138.      real symmetric band matrix A.  Eigenvalues/vectors can be selected by
  5139.      specifying either a range of values or a range of indices for the desired
  5140.      eigenvalues.
  5141.  
  5142.  
  5143.  
  5144.  
  5145.                                                                        PPPPaaaaggggeeee 77778888
  5146.  
  5147.  
  5148.  
  5149.  
  5150.  
  5151.  
  5152. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  5153.  
  5154.  
  5155.  
  5156.      SSBTRD reduces a real symmetric band matrix A to symmetric tridiagonal
  5157.      form T by an orthogonal similarity transformation:  Q**T * A * Q = T.
  5158.  
  5159.      SSPCON estimates the reciprocal of the condition number (in the 1-norm)
  5160.      of a real symmetric packed matrix A using the factorization A = U*D*U**T
  5161.      or A = L*D*L**T computed by SSPTRF.
  5162.  
  5163.      SSPEV computes all the eigenvalues and, optionally, eigenvectors of a
  5164.      real symmetric matrix A in packed storage.
  5165.  
  5166.      SSPEVX computes selected eigenvalues and, optionally, eigenvectors of a
  5167.      real symmetric matrix A in packed storage.  Eigenvalues/vectors can be
  5168.      selected by specifying either a range of values or a range of indices for
  5169.      the desired eigenvalues.
  5170.  
  5171.      SSPGST reduces a real symmetric-definite generalized eigenproblem to
  5172.      standard form, using packed storage.
  5173.  
  5174.      SSPGV computes all the eigenvalues and, optionally, the eigenvectors of a
  5175.      real generalized symmetric-definite eigenproblem, of the form
  5176.      A*x=(lambda)*B*x,  A*Bx=(lambda)*x,  or B*A*x=(lambda)*x.  Here A and B
  5177.      are assumed to be symmetric, stored in packed format, and B is also
  5178.      positive definite.
  5179.  
  5180.      SSPRFS improves the computed solution to a system of linear equations
  5181.      when the coefficient matrix is symmetric indefinite and packed, and
  5182.      provides error bounds and backward error estimates for the solution.
  5183.  
  5184.      SSPSV computes the solution to a real system of linear equations
  5185.         A * X = B, where A is an N-by-N symmetric matrix stored in packed
  5186.      format and X and B are N-by-NRHS matrices.
  5187.  
  5188.      SSPSVX uses the diagonal pivoting factorization A = U*D*U**T or A =
  5189.      L*D*L**T to compute the solution to a real system of linear equations A *
  5190.      X = B, where A is an N-by-N symmetric matrix stored in packed format and
  5191.      X and B are N-by-NRHS matrices.
  5192.  
  5193.      SSPTRD reduces a real symmetric matrix A stored in packed form to
  5194.      symmetric tridiagonal form T by an orthogonal similarity transformation:
  5195.      Q**T * A * Q = T.
  5196.  
  5197.      SSPTRF computes the factorization of a real symmetric matrix A stored in
  5198.      packed format using the Bunch-Kaufman diagonal pivoting method:
  5199.  
  5200.         A = U*D*U**T  or  A = L*D*L**T
  5201.  
  5202.      SSPTRI computes the inverse of a real symmetric indefinite matrix A in
  5203.      packed storage using the factorization A = U*D*U**T or A = L*D*L**T
  5204.      computed by SSPTRF.
  5205.  
  5206.      SSPTRS solves a system of linear equations A*X = B with a real symmetric
  5207.      matrix A stored in packed format using the factorization A = U*D*U**T or
  5208.  
  5209.  
  5210.  
  5211.                                                                        PPPPaaaaggggeeee 77779999
  5212.  
  5213.  
  5214.  
  5215.  
  5216.  
  5217.  
  5218. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  5219.  
  5220.  
  5221.  
  5222.      A = L*D*L**T computed by SSPTRF.
  5223.  
  5224.      SSTEBZ computes the eigenvalues of a symmetric tridiagonal matrix T.  The
  5225.      user may ask for all eigenvalues, all eigenvalues in the half-open
  5226.      interval (VL, VU], or the IL-th through IU-th eigenvalues.
  5227.  
  5228.      SSTEIN computes the eigenvectors of a real symmetric tridiagonal matrix T
  5229.      corresponding to specified eigenvalues, using inverse iteration.
  5230.  
  5231.      SSTEQR computes all eigenvalues and, optionally, eigenvectors of a
  5232.      symmetric tridiagonal matrix using the implicit QL or QR method.  The
  5233.      eigenvectors of a full or band symmetric matrix can also be found if
  5234.      SSYTRD or SSPTRD or SSBTRD has been used to reduce this matrix to
  5235.      tridiagonal form.
  5236.  
  5237.      SSTERF computes all eigenvalues of a symmetric tridiagonal matrix using
  5238.      the Pal-Walker-Kahan variant of the QL or QR algorithm.
  5239.  
  5240.      SSTEV computes all eigenvalues and, optionally, eigenvectors of a real
  5241.      symmetric tridiagonal matrix A.
  5242.  
  5243.      SSTEVX computes selected eigenvalues and, optionally, eigenvectors of a
  5244.      real symmetric tridiagonal matrix A.  Eigenvalues/vectors can be selected
  5245.      by specifying either a range of values or a range of indices for the
  5246.      desired eigenvalues.
  5247.  
  5248.      SSYCON estimates the reciprocal of the condition number (in the 1-norm)
  5249.      of a real symmetric matrix A using the factorization A = U*D*U**T or A =
  5250.      L*D*L**T computed by SSYTRF.
  5251.  
  5252.      SSYEV computes all eigenvalues and, optionally, eigenvectors of a real
  5253.      symmetric matrix A.
  5254.  
  5255.      SSYEVX computes selected eigenvalues and, optionally, eigenvectors of a
  5256.      real symmetric matrix A.  Eigenvalues and eigenvectors can be selected by
  5257.      specifying either a range of values or a range of indices for the desired
  5258.      eigenvalues.
  5259.  
  5260.      SSYGS2 reduces a real symmetric-definite generalized eigenproblem to
  5261.      standard form.
  5262.  
  5263.      SSYGST reduces a real symmetric-definite generalized eigenproblem to
  5264.      standard form.
  5265.  
  5266.      SSYGV computes all the eigenvalues, and optionally, the eigenvectors of a
  5267.      real generalized symmetric-definite eigenproblem, of the form
  5268.      A*x=(lambda)*B*x,  A*Bx=(lambda)*x,  or B*A*x=(lambda)*x.  Here A and B
  5269.      are assumed to be symmetric and B is also
  5270.  
  5271.      SSYRFS improves the computed solution to a system of linear equations
  5272.      when the coefficient matrix is symmetric indefinite, and provides error
  5273.      bounds and backward error estimates for the solution.
  5274.  
  5275.  
  5276.  
  5277.                                                                        PPPPaaaaggggeeee 88880000
  5278.  
  5279.  
  5280.  
  5281.  
  5282.  
  5283.  
  5284. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  5285.  
  5286.  
  5287.  
  5288.      SSYSV computes the solution to a real system of linear equations
  5289.         A * X = B, where A is an N-by-N symmetric matrix and X and B are N-
  5290.      by-NRHS matrices.
  5291.  
  5292.      SSYSVX uses the diagonal pivoting factorization to compute the solution
  5293.      to a real system of linear equations A * X = B, where A is an N-by-N
  5294.      symmetric matrix and X and B are N-by-NRHS matrices.
  5295.  
  5296.      SSYTD2 reduces a real symmetric matrix A to symmetric tridiagonal form T
  5297.      by an orthogonal similarity transformation: Q' * A * Q = T.
  5298.  
  5299.      SSYTF2 computes the factorization of a real symmetric matrix A using the
  5300.      Bunch-Kaufman diagonal pivoting method:
  5301.  
  5302.         A = U*D*U'  or  A = L*D*L'
  5303.  
  5304.      SSYTRD reduces a real symmetric matrix A to real symmetric tridiagonal
  5305.      form T by an orthogonal similarity transformation:  Q**T * A * Q = T.
  5306.  
  5307.      SSYTRF computes the factorization of a real symmetric matrix A using the
  5308.      Bunch-Kaufman diagonal pivoting method.  The form of the factorization is
  5309.  
  5310.      SSYTRI computes the inverse of a real symmetric indefinite matrix A using
  5311.      the factorization A = U*D*U**T or A = L*D*L**T computed by SSYTRF.
  5312.  
  5313.      SSYTRS solves a system of linear equations A*X = B with a real symmetric
  5314.      matrix A using the factorization A = U*D*U**T or A = L*D*L**T computed by
  5315.      SSYTRF.
  5316.  
  5317.      STBCON estimates the reciprocal of the condition number of a triangular
  5318.      band matrix A, in either the 1-norm or the infinity-norm.
  5319.  
  5320.      STBRFS provides error bounds and backward error estimates for the
  5321.      solution to a system of linear equations with a triangular band
  5322.      coefficient matrix.
  5323.  
  5324.      STBTRS solves a triangular system of the form
  5325.  
  5326.      where A is a triangular band matrix of order N, and B is an N-by NRHS
  5327.      matrix.  A check is made to verify that A is nonsingular.
  5328.  
  5329.      STGEVC computes selected left and/or right generalized eigenvectors of a
  5330.      pair of real upper triangular matrices (A,B).  The j-th generalized left
  5331.      and right eigenvectors are  y  and  x, resp., such that:
  5332.  
  5333.      STGSJA computes the generalized singular value decomposition (GSVD) of
  5334.      two real upper ``triangular (or trapezoidal)'' matrices A and B.
  5335.  
  5336.      STPCON estimates the reciprocal of the condition number of a packed
  5337.      triangular matrix A, in either the 1-norm or the infinity-norm.
  5338.  
  5339.      STPRFS provides error bounds and backward error estimates for the
  5340.  
  5341.  
  5342.  
  5343.                                                                        PPPPaaaaggggeeee 88881111
  5344.  
  5345.  
  5346.  
  5347.  
  5348.  
  5349.  
  5350. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  5351.  
  5352.  
  5353.  
  5354.      solution to a system of linear equations with a triangular packed
  5355.      coefficient matrix.
  5356.  
  5357.      STPTRI computes the inverse of a real upper or lower triangular matrix A
  5358.      stored in packed format.
  5359.  
  5360.      STPTRS solves a triangular system of the form
  5361.  
  5362.      where A is a triangular matrix of order N stored in packed format, and B
  5363.      is an N-by-NRHS matrix.  A check is made to verify that A is nonsingular.
  5364.  
  5365.      STRCON estimates the reciprocal of the condition number of a triangular
  5366.      matrix A, in either the 1-norm or the infinity-norm.
  5367.  
  5368.      STREVC computes all or some right and/or left eigenvectors of a real
  5369.      upper quasi-triangular matrix T.
  5370.  
  5371.      STREXC reorders the real Schur factorization of a real matrix A =
  5372.      Q*T*Q**T, so that the diagonal block of T with row index IFST is moved to
  5373.      row ILST.
  5374.  
  5375.      STRRFS provides error bounds and backward error estimates for the
  5376.      solution to a system of linear equations with a triangular coefficient
  5377.      matrix.
  5378.  
  5379.      STRSEN reorders the real Schur factorization of a real matrix A =
  5380.      Q*T*Q**T, so that a selected cluster of eigenvalues appears in the
  5381.      leading diagonal blocks of the upper quasi-triangular matrix T, and the
  5382.      leading columns of Q form an orthonormal basis of the corresponding right
  5383.      invariant subspace.
  5384.  
  5385.      STRSNA estimates reciprocal condition numbers for specified eigenvalues
  5386.      and/or right eigenvectors of a real upper quasi-triangular matrix T (or
  5387.      of any matrix Q*T*Q**T with Q orthogonal).
  5388.  
  5389.      STRSYL solves the real Sylvester matrix equation:
  5390.  
  5391.         op(A)*X + X*op(B) = scale*C or
  5392.  
  5393.      STRTI2 computes the inverse of a real upper or lower triangular matrix.
  5394.  
  5395.      STRTRI computes the inverse of a real upper or lower triangular matrix A.
  5396.  
  5397.      STRTRS solves a triangular system of the form
  5398.  
  5399.      where A is a triangular matrix of order N, and B is an N-by-NRHS matrix.
  5400.      A check is made to verify that A is nonsingular.
  5401.  
  5402.      STZRQF reduces the M-by-N ( M<=N ) real upper trapezoidal matrix A to
  5403.      upper triangular form by means of orthogonal transformations.
  5404.  
  5405.      XERBLA  is an error handler for the LAPACK routines.  It is called by an
  5406.  
  5407.  
  5408.  
  5409.                                                                        PPPPaaaaggggeeee 88882222
  5410.  
  5411.  
  5412.  
  5413.  
  5414.  
  5415.  
  5416. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  5417.  
  5418.  
  5419.  
  5420.      LAPACK routine if an input parameter has an invalid value.  A message is
  5421.      printed and execution stops.
  5422.  
  5423.      DBDSQR computes the singular value decomposition (SVD) of a real N-by-N
  5424.      (upper or lower) bidiagonal matrix B:  B = Q * S * P' (P' denotes the
  5425.      transpose of P), where S is a diagonal matrix with non-negative diagonal
  5426.      elements (the singular values of B), and Q and P are orthogonal matrices.
  5427.  
  5428.  
  5429.  
  5430.      ZDRSCL multiplies an n-element complex vector x by the real scalar 1/a.
  5431.      This is done without overflow or underflow as long as the final result
  5432.      x/a does not overflow or underflow.
  5433.  
  5434.      ZGBCON estimates the reciprocal of the condition number of a complex
  5435.      general band matrix A, in either the 1-norm or the infinity-norm, using
  5436.      the LU factorization computed by ZGBTRF.
  5437.  
  5438.      ZGBEQU computes row and column scalings intended to equilibrate an M by N
  5439.      band matrix A and reduce its condition number.  R returns the row scale
  5440.      factors and C the column scale factors, chosen to try to make the largest
  5441.      element in each row and column of the matrix B with elements
  5442.      B(i,j)=R(i)*A(i,j)*C(j) have absolute value 1.
  5443.  
  5444.      ZGBRFS improves the computed solution to a system of linear equations
  5445.      when the coefficient matrix is banded, and provides error bounds and
  5446.      backward error estimates for the solution.
  5447.  
  5448.      ZGBSV computes the solution to a complex system of linear equations A * X
  5449.      = B, where A is a band matrix of order N with KL subdiagonals and KU
  5450.      superdiagonals, and X and B are N-by-NRHS matrices.
  5451.  
  5452.      ZGBSVX uses the LU factorization to compute the solution to a complex
  5453.      system of linear equations A * X = B, A**T * X = B, or A**H * X = B,
  5454.      where A is a band matrix of order N with KL subdiagonals and KU
  5455.      superdiagonals, and X and B are N-by-NRHS matrices.
  5456.  
  5457.      ZGBTF2 computes an LU factorization of a complex m-by-n band matrix A
  5458.      using partial pivoting with row interchanges.
  5459.  
  5460.      ZGBTRF computes an LU factorization of a complex m-by-n band matrix A
  5461.      using partial pivoting with row interchanges.
  5462.  
  5463.      ZGBTRS solves a system of linear equations
  5464.         A * X = B,  A**T * X = B,  or  A**H * X = B with a general band matrix
  5465.      A using the LU factorization computed by ZGBTRF.
  5466.  
  5467.      ZGEBAK forms the right or left eigenvectors of a complex general matrix
  5468.      by backward transformation on the computed eigenvectors of the balanced
  5469.      matrix output by ZGEBAL.
  5470.  
  5471.      ZGEBAL balances a general complex matrix A.  This involves, first,
  5472.  
  5473.  
  5474.  
  5475.                                                                        PPPPaaaaggggeeee 88883333
  5476.  
  5477.  
  5478.  
  5479.  
  5480.  
  5481.  
  5482. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  5483.  
  5484.  
  5485.  
  5486.      permuting A by a similarity transformation to isolate eigenvalues in the
  5487.      first 1 to ILO-1 and last IHI+1 to N elements on the diagonal; and
  5488.      second, applying a diagonal similarity transformation to rows and columns
  5489.      ILO to IHI to make the rows and columns as close in norm as possible.
  5490.      Both steps are optional.
  5491.  
  5492.      ZGEBD2 reduces a complex general m by n matrix A to upper or lower real
  5493.      bidiagonal form B by a unitary transformation: Q' * A * P = B.
  5494.  
  5495.      ZGEBRD reduces a general complex M-by-N matrix A to upper or lower
  5496.      bidiagonal form B by a unitary transformation: Q**H * A * P = B.
  5497.  
  5498.      ZGECON estimates the reciprocal of the condition number of a general
  5499.      complex matrix A, in either the 1-norm or the infinity-norm, using the LU
  5500.      factorization computed by ZGETRF.
  5501.  
  5502.      ZGEEQU computes row and column scalings intended to equilibrate an M by N
  5503.      matrix A and reduce its condition number.  R returns the row scale
  5504.      factors and C the column scale factors, chosen to try to make the largest
  5505.      entry in each row and column of the matrix B with elements
  5506.      B(i,j)=R(i)*A(i,j)*C(j) have absolute value 1.
  5507.  
  5508.      ZGEES computes for an N-by-N complex nonsymmetric matrix A, the
  5509.      eigenvalues, the Schur form T, and, optionally, the matrix of Schur
  5510.      vectors Z.  This gives the Schur factorization A = Z*T*(Z**H).
  5511.  
  5512.      ZGEESX computes for an N-by-N complex nonsymmetric matrix A, the
  5513.      eigenvalues, the Schur form T, and, optionally, the matrix of Schur
  5514.      vectors Z.  This gives the Schur factorization A = Z*T*(Z**H).
  5515.  
  5516.      ZGEEV computes for an N-by-N complex nonsymmetric matrix A, the
  5517.      eigenvalues and, optionally, the left and/or right eigenvectors.
  5518.  
  5519.      ZGEEVX computes for an N-by-N complex nonsymmetric matrix A, the
  5520.      eigenvalues and, optionally, the left and/or right eigenvectors.
  5521.  
  5522.      For a pair of N-by-N complex nonsymmetric matrices A, B:
  5523.  
  5524.         compute the generalized eigenvalues (alpha, beta)
  5525.  
  5526.      For a pair of N-by-N complex nonsymmetric matrices A, B:
  5527.  
  5528.         compute the generalized eigenvalues (alpha, beta)
  5529.  
  5530.      ZGEHD2 reduces a complex general matrix A to upper Hessenberg form H by a
  5531.      unitary similarity transformation:  Q' * A * Q = H .
  5532.  
  5533.      ZGEHRD reduces a complex general matrix A to upper Hessenberg form H by a
  5534.      unitary similarity transformation:  Q' * A * Q = H .
  5535.  
  5536.      ZGELQ2 computes an LQ factorization of a complex m by n matrix A:  A = L
  5537.      * Q.
  5538.  
  5539.  
  5540.  
  5541.                                                                        PPPPaaaaggggeeee 88884444
  5542.  
  5543.  
  5544.  
  5545.  
  5546.  
  5547.  
  5548. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  5549.  
  5550.  
  5551.  
  5552.      ZGELQF computes an LQ factorization of a complex M-by-N matrix A:  A = L
  5553.      * Q.
  5554.  
  5555.      ZGELS solves overdetermined or underdetermined complex linear systems
  5556.      involving an M-by-N matrix A, or its conjugate-transpose, using a QR or
  5557.      LQ factorization of A.  It is assumed that A has full rank.
  5558.  
  5559.      ZGELSS computes the minimum norm solution to a complex linear least
  5560.      squares problem:
  5561.  
  5562.      Minimize 2-norm(| b - A*x |).
  5563.  
  5564.      ZGELSX computes the minimum-norm solution to a complex linear least
  5565.      squares problem:
  5566.          minimize || A * X - B ||
  5567.  
  5568.      ZGEQL2 computes a QL factorization of a complex m by n matrix A:  A = Q *
  5569.      L.
  5570.  
  5571.      ZGEQLF computes a QL factorization of a complex M-by-N matrix A:  A = Q *
  5572.      L.
  5573.  
  5574.      ZGEQPF computes a QR factorization with column pivoting of a complex M-
  5575.      by-N matrix A: A*P = Q*R.
  5576.  
  5577.      ZGEQR2 computes a QR factorization of a complex m by n matrix A:  A = Q *
  5578.      R.
  5579.  
  5580.      ZGEQRF computes a QR factorization of a complex M-by-N matrix A:  A = Q *
  5581.      R.
  5582.  
  5583.      ZGERFS improves the computed solution to a system of linear equations and
  5584.      provides error bounds and backward error estimates for the solution.
  5585.  
  5586.      ZGERQ2 computes an RQ factorization of a complex m by n matrix A:  A = R
  5587.      * Q.
  5588.  
  5589.      ZGERQF computes an RQ factorization of a complex M-by-N matrix A:  A = R
  5590.      * Q.
  5591.  
  5592.      ZGESV computes the solution to a complex system of linear equations
  5593.         A * X = B, where A is an N-by-N matrix and X and B are N-by-NRHS
  5594.      matrices.
  5595.  
  5596.      ZGESVD computes the singular value decomposition (SVD) of a complex M-
  5597.      by-N matrix A, optionally computing the left and/or right singular
  5598.      vectors. The SVD is written
  5599.  
  5600.           A = U * SIGMA * conjugate-transpose(V)
  5601.  
  5602.      ZGESVX uses the LU factorization to compute the solution to a complex
  5603.      system of linear equations
  5604.  
  5605.  
  5606.  
  5607.                                                                        PPPPaaaaggggeeee 88885555
  5608.  
  5609.  
  5610.  
  5611.  
  5612.  
  5613.  
  5614. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  5615.  
  5616.  
  5617.  
  5618.         A * X = B, where A is an N-by-N matrix and X and B are N-by-NRHS
  5619.      matrices.
  5620.  
  5621.      ZGETF2 computes an LU factorization of a general m-by-n matrix A using
  5622.      partial pivoting with row interchanges.
  5623.  
  5624.      ZGETRF computes an LU factorization of a general M-by-N matrix A using
  5625.      partial pivoting with row interchanges.
  5626.  
  5627.      ZGETRI computes the inverse of a matrix using the LU factorization
  5628.      computed by ZGETRF.
  5629.  
  5630.      ZGETRS solves a system of linear equations
  5631.         A * X = B,  A**T * X = B,  or  A**H * X = B with a general N-by-N
  5632.      matrix A using the LU factorization computed by ZGETRF.
  5633.  
  5634.      ZGGBAK forms the right or left eigenvectors of the generalized eigenvalue
  5635.      problem by backward transformation on the computed eigenvectors of the
  5636.      balanced matrix output by ZGGBAL.
  5637.  
  5638.      ZGGBAL balances a pair of general complex matrices (A,B) for the
  5639.      generalized eigenvalue problem A*X = lambda*B*X.  This involves, first,
  5640.      permuting A and B by similarity transformations to isolate eigenvalues in
  5641.      the first 1 to ILO-1 and last IHI+1 to N elements on the diagonal; and
  5642.      second, applying a diagonal similarity
  5643.  
  5644.      ZGGGLM solves a generalized linear regression model (GLM) problem:
  5645.  
  5646.              minimize y'*y     subject to    d = A*x + B*y
  5647.  
  5648.      ZGGHRD reduces a pair of complex matrices (A,B) to generalized upper
  5649.      Hessenberg form using unitary similarity transformations, where A is a
  5650.      (generally non-symmetric) square matrix and B is upper triangular.  More
  5651.      precisely, ZGGHRD simultaneously decomposes  A into  Q H Z* and  B  into
  5652.      Q T Z* , where H is upper Hessenberg, T is upper triangular, Q and Z are
  5653.      unitary, and * means conjugate transpose.
  5654.  
  5655.      ZGGLSE solves the linear equality constrained least squares (LSE)
  5656.      problem:
  5657.  
  5658.              minimize || A*x - c ||_2   subject to B*x = d
  5659.  
  5660.      ZGGQRF computes a generalized QR factorization of an N-by-M matrix A and
  5661.      an N-by-P matrix B:
  5662.  
  5663.                  A = Q*R,        B = Q*T*Z,
  5664.  
  5665.      ZGGRQF computes a generalized RQ factorization of an M-by-N matrix A and
  5666.      a P-by-N matrix B:
  5667.  
  5668.                  A = R*Q,        B = Z*T*Q,
  5669.  
  5670.  
  5671.  
  5672.  
  5673.                                                                        PPPPaaaaggggeeee 88886666
  5674.  
  5675.  
  5676.  
  5677.  
  5678.  
  5679.  
  5680. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  5681.  
  5682.  
  5683.  
  5684.      ZGGSVD computes the generalized singular value decomposition (GSVD) of
  5685.      the M-by-N complex matrix A and P-by-N complex matrix B:
  5686.  
  5687.            U'*A*Q = D1*( 0 R ),    V'*B*Q = D2*( 0 R )               (1)
  5688.  
  5689.      where U, V and Q are unitary matrices, R is an upper triangular matrix,
  5690.      and Z' means the conjugate transpose of Z.  Let K+L = the numerical
  5691.      effective rank of the matrix (A',B')', then D1 and D2 are M-by-(K+L) and
  5692.      P-by-(K+L) "diagonal" matrices and of the following structures,
  5693.      respectively:
  5694.  
  5695.      ZGGSVP computes unitary matrices U, V and Q such that A23 is upper
  5696.      trapezoidal.  K+L = the effective rank of the (M+P)-by-N matrix (A',B')'.
  5697.      Z' denotes the conjugate transpose of Z.
  5698.  
  5699.      ZGTCON estimates the reciprocal of the condition number of a complex
  5700.      tridiagonal matrix A using the LU factorization as computed by ZGTTRF.
  5701.  
  5702.      ZGTRFS improves the computed solution to a system of linear equations
  5703.      when the coefficient matrix is tridiagonal, and provides error bounds and
  5704.      backward error estimates for the solution.
  5705.  
  5706.      ZGTSV  solves the equation
  5707.  
  5708.      where A is an N-by-N tridiagonal matrix, by Gaussian elimination with
  5709.      partial pivoting.
  5710.  
  5711.      ZGTSVX uses the LU factorization to compute the solution to a complex
  5712.      system of linear equations A * X = B, A**T * X = B, or A**H * X = B,
  5713.      where A is a tridiagonal matrix of order N and X and B are N-by-NRHS
  5714.      matrices.
  5715.  
  5716.      ZGTTRF computes an LU factorization of a complex tridiagonal matrix A
  5717.      using elimination with partial pivoting and row interchanges.
  5718.  
  5719.      ZGTTRS solves one of the systems of equations
  5720.         A * X = B,  A**T * X = B,  or  A**H * X = B, with a tridiagonal matrix
  5721.      A using the LU factorization computed by ZGTTRF.
  5722.  
  5723.      ZHBEV computes all the eigenvalues and, optionally, eigenvectors of a
  5724.      complex Hermitian band matrix A.
  5725.  
  5726.      ZHBEVX computes selected eigenvalues and, optionally, eigenvectors of a
  5727.      complex Hermitian band matrix A.  Eigenvalues/vectors can be selected by
  5728.      specifying either a range of values or a range of indices for the desired
  5729.      eigenvalues.
  5730.  
  5731.      ZHBTRD reduces a complex Hermitian band matrix A to real symmetric
  5732.      tridiagonal form T by a unitary similarity transformation:  Q**H * A * Q
  5733.      = T.
  5734.  
  5735.      ZHECON estimates the reciprocal of the condition number of a complex
  5736.  
  5737.  
  5738.  
  5739.                                                                        PPPPaaaaggggeeee 88887777
  5740.  
  5741.  
  5742.  
  5743.  
  5744.  
  5745.  
  5746. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  5747.  
  5748.  
  5749.  
  5750.      Hermitian matrix A using the factorization A = U*D*U**H or A = L*D*L**H
  5751.      computed by ZHETRF.
  5752.  
  5753.      ZHEEV computes all eigenvalues and, optionally, eigenvectors of a complex
  5754.      Hermitian matrix A.
  5755.  
  5756.      ZHEEVX computes selected eigenvalues and, optionally, eigenvectors of a
  5757.      complex Hermitian matrix A.  Eigenvalues and eigenvectors can be selected
  5758.      by specifying either a range of values or a range of indices for the
  5759.      desired eigenvalues.
  5760.  
  5761.      ZHEGS2 reduces a complex Hermitian-definite generalized eigenproblem to
  5762.      standard form.
  5763.  
  5764.      ZHEGST reduces a complex Hermitian-definite generalized eigenproblem to
  5765.      standard form.
  5766.  
  5767.      ZHEGV computes all the eigenvalues, and optionally, the eigenvectors of a
  5768.      complex generalized Hermitian-definite eigenproblem, of the form
  5769.      A*x=(lambda)*B*x,  A*Bx=(lambda)*x,  or B*A*x=(lambda)*x.  Here A and B
  5770.      are assumed to be Hermitian and B is also
  5771.  
  5772.      ZHERFS improves the computed solution to a system of linear equations
  5773.      when the coefficient matrix is Hermitian indefinite, and provides error
  5774.      bounds and backward error estimates for the solution.
  5775.  
  5776.      ZHESV computes the solution to a complex system of linear equations
  5777.         A * X = B, where A is an N-by-N Hermitian matrix and X and B are N-
  5778.      by-NRHS matrices.
  5779.  
  5780.      ZHESVX uses the diagonal pivoting factorization to compute the solution
  5781.      to a complex system of linear equations A * X = B, where A is an N-by-N
  5782.      Hermitian matrix and X and B are N-by-NRHS matrices.
  5783.  
  5784.      ZHETD2 reduces a complex Hermitian matrix A to real symmetric tridiagonal
  5785.      form T by a unitary similarity transformation:  Q' * A * Q = T.
  5786.  
  5787.      ZHETF2 computes the factorization of a complex Hermitian matrix A using
  5788.      the Bunch-Kaufman diagonal pivoting method:
  5789.  
  5790.         A = U*D*U'  or  A = L*D*L'
  5791.  
  5792.      ZHETRD reduces a complex Hermitian matrix A to real symmetric tridiagonal
  5793.      form T by a unitary similarity transformation:  Q**H * A * Q = T.
  5794.  
  5795.      ZHETRF computes the factorization of a complex Hermitian matrix A using
  5796.      the Bunch-Kaufman diagonal pivoting method.  The form of the
  5797.      factorization is
  5798.  
  5799.      ZHETRI computes the inverse of a complex Hermitian indefinite matrix A
  5800.      using the factorization A = U*D*U**H or A = L*D*L**H computed by ZHETRF.
  5801.  
  5802.  
  5803.  
  5804.  
  5805.                                                                        PPPPaaaaggggeeee 88888888
  5806.  
  5807.  
  5808.  
  5809.  
  5810.  
  5811.  
  5812. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  5813.  
  5814.  
  5815.  
  5816.      ZHETRS solves a system of linear equations A*X = B with a complex
  5817.      Hermitian matrix A using the factorization A = U*D*U**H or A = L*D*L**H
  5818.      computed by ZHETRF.
  5819.  
  5820.      ZHGEQZ implements a single-shift version of the QZ method for finding the
  5821.      generalized eigenvalues w(i)=ALPHA(i)/BETA(i) of the equation A are then
  5822.      ALPHA(1),...,ALPHA(N), and of B are BETA(1),...,BETA(N).
  5823.  
  5824.      ZHPCON estimates the reciprocal of the condition number of a complex
  5825.      Hermitian packed matrix A using the factorization A = U*D*U**H or A =
  5826.      L*D*L**H computed by ZHPTRF.
  5827.  
  5828.      ZHPEV computes all the eigenvalues and, optionally, eigenvectors of a
  5829.      complex Hermitian matrix in packed storage.
  5830.  
  5831.      ZHPEVX computes selected eigenvalues and, optionally, eigenvectors of a
  5832.      complex Hermitian matrix A in packed storage.  Eigenvalues/vectors can be
  5833.      selected by specifying either a range of values or a range of indices for
  5834.      the desired eigenvalues.
  5835.  
  5836.      ZHPGST reduces a complex Hermitian-definite generalized eigenproblem to
  5837.      standard form, using packed storage.
  5838.  
  5839.      ZHPGV computes all the eigenvalues and, optionally, the eigenvectors of a
  5840.      complex generalized Hermitian-definite eigenproblem, of the form
  5841.      A*x=(lambda)*B*x,  A*Bx=(lambda)*x,  or B*A*x=(lambda)*x.  Here A and B
  5842.      are assumed to be Hermitian, stored in packed format, and B is also
  5843.      positive definite.
  5844.  
  5845.      ZHPRFS improves the computed solution to a system of linear equations
  5846.      when the coefficient matrix is Hermitian indefinite and packed, and
  5847.      provides error bounds and backward error estimates for the solution.
  5848.  
  5849.      ZHPSV computes the solution to a complex system of linear equations
  5850.         A * X = B, where A is an N-by-N Hermitian matrix stored in packed
  5851.      format and X and B are N-by-NRHS matrices.
  5852.  
  5853.      ZHPSVX uses the diagonal pivoting factorization A = U*D*U**H or A =
  5854.      L*D*L**H to compute the solution to a complex system of linear equations
  5855.      A * X = B, where A is an N-by-N Hermitian matrix stored in packed format
  5856.      and X and B are N-by-NRHS matrices.
  5857.  
  5858.      ZHPTRD reduces a complex Hermitian matrix A stored in packed form to real
  5859.      symmetric tridiagonal form T by a unitary similarity transformation: Q**H
  5860.      * A * Q = T.
  5861.  
  5862.      ZHPTRF computes the factorization of a complex Hermitian packed matrix A
  5863.      using the Bunch-Kaufman diagonal pivoting method:
  5864.  
  5865.         A = U*D*U**H  or  A = L*D*L**H
  5866.  
  5867.      ZHPTRI computes the inverse of a complex Hermitian indefinite matrix A in
  5868.  
  5869.  
  5870.  
  5871.                                                                        PPPPaaaaggggeeee 88889999
  5872.  
  5873.  
  5874.  
  5875.  
  5876.  
  5877.  
  5878. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  5879.  
  5880.  
  5881.  
  5882.      packed storage using the factorization A = U*D*U**H or A = L*D*L**H
  5883.      computed by ZHPTRF.
  5884.  
  5885.      ZHPTRS solves a system of linear equations A*X = B with a complex
  5886.      Hermitian matrix A stored in packed format using the factorization A =
  5887.      U*D*U**H or A = L*D*L**H computed by ZHPTRF.
  5888.  
  5889.      ZHSEIN uses inverse iteration to find specified right and/or left
  5890.      eigenvectors of a complex upper Hessenberg matrix H.
  5891.  
  5892.      ZHSEQR computes the eigenvalues of a complex upper Hessenberg matrix H,
  5893.      and, optionally, the matrices T and Z from the Schur decomposition H = Z
  5894.      T Z**H, where T is an upper triangular matrix (the Schur form), and Z is
  5895.      the unitary matrix of Schur vectors.
  5896.  
  5897.      ZLABRD reduces the first NB rows and columns of a complex general m by n
  5898.      matrix A to upper or lower real bidiagonal form by a unitary
  5899.      transformation Q' * A * P, and returns the matrices X and Y which are
  5900.      needed to apply the transformation to the unreduced part of A.
  5901.  
  5902.      ZLACGV conjugates a complex vector of length N.
  5903.  
  5904.      ZLACON estimates the 1-norm of a square, complex matrix A.  Reverse
  5905.      communication is used for evaluating matrix-vector products.
  5906.  
  5907.      ZLACPY copies all or part of a two-dimensional matrix A to another matrix
  5908.      B.
  5909.  
  5910.      ZLACRT applies a plane rotation, where the cos and sin (C and S) are
  5911.      complex and the vectors CX and CY are complex.
  5912.  
  5913.      ZLADIV := X / Y, where X and Y are complex.  The computation of X / Y
  5914.      will not overflow on an intermediary step unless the results overflows.
  5915.  
  5916.      ZLAEIN uses inverse iteration to find a right or left eigenvector
  5917.      corresponding to the eigenvalue W of a complex upper Hessenberg matrix H.
  5918.  
  5919.      ZLAESY computes the eigendecomposition of a 2x2 symmetric matrix
  5920.         ( ( A, B );( B, C ) ) provided the norm of the matrix of eigenvectors
  5921.      is larger than some threshold value.
  5922.  
  5923.      ZLAEV2 computes the eigendecomposition of a 2-by-2 Hermitian matrix
  5924.         [  A         B  ]
  5925.         [  CONJG(B)  C  ].  On return, RT1 is the eigenvalue of larger
  5926.      absolute value, RT2 is the eigenvalue of smaller absolute value, and
  5927.      (CS1,SN1) is the unit right eigenvector for RT1, giving the decomposition
  5928.  
  5929.      ZLAGS2 computes 2-by-2 unitary matrices U, V and Q, such that if ( UPPER
  5930.      ) then
  5931.            ( -CONJG(SNU)  CSU )      ( -CONJG(SNV) CSV )
  5932.  
  5933.      ZLAGTM performs a matrix-vector product of the form
  5934.  
  5935.  
  5936.  
  5937.                                                                        PPPPaaaaggggeeee 99990000
  5938.  
  5939.  
  5940.  
  5941.  
  5942.  
  5943.  
  5944. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  5945.  
  5946.  
  5947.  
  5948.      ZLAHEF computes a partial factorization of a complex Hermitian matrix A
  5949.      using the Bunch-Kaufman diagonal pivoting method. The partial
  5950.      factorization has the form:
  5951.  
  5952.      ZLAHQR is an auxiliary routine called by ZHSEQR to update the eigenvalues
  5953.      and Schur decomposition already computed by ZHSEQR, by dealing with the
  5954.      Hessenberg submatrix in rows and columns ILO to IHI.
  5955.  
  5956.      ZLAHRD reduces the first NB columns of a complex general n-by-(n-k+1)
  5957.      matrix A so that elements below the k-th subdiagonal are zero. The
  5958.      reduction is performed by a unitary similarity transformation Q' * A * Q.
  5959.      The routine returns the matrices V and T which determine Q as a block
  5960.      reflector I - V*T*V', and also the matrix Y = A * V * T.
  5961.  
  5962.      ZLAIC1 applies one step of incremental condition estimation in its
  5963.      simplest version:
  5964.  
  5965.      Let x, twonorm(x) = 1, be an approximate singular vector of an j-by-j
  5966.      lower triangular matrix L, such that
  5967.  
  5968.      ZLANGB  returns the value of the one norm,  or the Frobenius norm, or the
  5969.      infinity norm,  or the element of  largest absolute value  of an n by n
  5970.      band matrix  A,  with kl sub-diagonals and ku super-diagonals.
  5971.  
  5972.      ZLANGE  returns the value of the one norm,  or the Frobenius norm, or the
  5973.      infinity norm,  or the  element of  largest absolute value  of a complex
  5974.      matrix A.
  5975.  
  5976.      ZLANGT  returns the value of the one norm,  or the Frobenius norm, or the
  5977.      infinity norm,  or the  element of  largest absolute value  of a complex
  5978.      tridiagonal matrix A.
  5979.  
  5980.      ZLANHB  returns the value of the one norm,  or the Frobenius norm, or the
  5981.      infinity norm,  or the element of  largest absolute value  of an n by n
  5982.      hermitian band matrix A,  with k super-diagonals.
  5983.  
  5984.      ZLANHE  returns the value of the one norm,  or the Frobenius norm, or the
  5985.      infinity norm,  or the  element of  largest absolute value  of a complex
  5986.      hermitian matrix A.
  5987.  
  5988.      ZLANHP  returns the value of the one norm,  or the Frobenius norm, or the
  5989.      infinity norm,  or the  element of  largest absolute value  of a complex
  5990.      hermitian matrix A,  supplied in packed form.
  5991.  
  5992.      ZLANHS  returns the value of the one norm,  or the Frobenius norm, or the
  5993.      infinity norm,  or the  element of  largest absolute value  of a
  5994.      Hessenberg matrix A.
  5995.  
  5996.      ZLANHT  returns the value of the one norm,  or the Frobenius norm, or the
  5997.      infinity norm,  or the  element of  largest absolute value  of a complex
  5998.      Hermitian tridiagonal matrix A.
  5999.  
  6000.  
  6001.  
  6002.  
  6003.                                                                        PPPPaaaaggggeeee 99991111
  6004.  
  6005.  
  6006.  
  6007.  
  6008.  
  6009.  
  6010. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  6011.  
  6012.  
  6013.  
  6014.      ZLANSB  returns the value of the one norm,  or the Frobenius norm, or the
  6015.      infinity norm,  or the element of  largest absolute value  of an n by n
  6016.      symmetric band matrix A,  with k super-diagonals.
  6017.  
  6018.      ZLANSP  returns the value of the one norm,  or the Frobenius norm, or the
  6019.      infinity norm,  or the  element of  largest absolute value  of a complex
  6020.      symmetric matrix A,  supplied in packed form.
  6021.  
  6022.      ZLANSY  returns the value of the one norm,  or the Frobenius norm, or the
  6023.      infinity norm,  or the  element of  largest absolute value  of a complex
  6024.      symmetric matrix A.
  6025.  
  6026.      ZLANTB  returns the value of the one norm,  or the Frobenius norm, or the
  6027.      infinity norm,  or the element of  largest absolute value  of an n by n
  6028.      triangular band matrix A,  with ( k + 1 ) diagonals.
  6029.  
  6030.      ZLANTP  returns the value of the one norm,  or the Frobenius norm, or the
  6031.      infinity norm,  or the  element of  largest absolute value  of a
  6032.      triangular matrix A, supplied in packed form.
  6033.  
  6034.      ZLANTR  returns the value of the one norm,  or the Frobenius norm, or the
  6035.      infinity norm,  or the  element of  largest absolute value  of a
  6036.      trapezoidal or triangular matrix A.
  6037.  
  6038.      Given two column vectors X and Y, let
  6039.  
  6040.      The subroutine first computes the QR factorization of A = Q*R, and then
  6041.      computes the SVD of the 2-by-2 upper triangular matrix R.  The smaller
  6042.      singular value of R is returned in SSMIN, which is used as the
  6043.      measurement of the linear dependency of the vectors X and Y.
  6044.  
  6045.      ZLAPMT rearranges the columns of the M by N matrix X as specified by the
  6046.      permutation K(1),K(2),...,K(N) of the integers 1,...,N.  If FORWRD =
  6047.      .TRUE.,  forward permutation:
  6048.  
  6049.      ZLAQGB equilibrates a general M by N band matrix A with KL subdiagonals
  6050.      and KU superdiagonals using the row and scaling factors in the vectors R
  6051.      and C.
  6052.  
  6053.      ZLAQGE equilibrates a general M by N matrix A using the row and scaling
  6054.      factors in the vectors R and C.
  6055.  
  6056.      ZLAQSB equilibrates a symmetric band matrix A using the scaling factors
  6057.      in the vector S.
  6058.  
  6059.      ZLAQSP equilibrates a symmetric matrix A using the scaling factors in the
  6060.      vector S.
  6061.  
  6062.      ZLAQSY equilibrates a symmetric matrix A using the scaling factors in the
  6063.      vector S.
  6064.  
  6065.      ZLAR2V applies a vector of complex plane rotations with real cosines from
  6066.  
  6067.  
  6068.  
  6069.                                                                        PPPPaaaaggggeeee 99992222
  6070.  
  6071.  
  6072.  
  6073.  
  6074.  
  6075.  
  6076. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  6077.  
  6078.  
  6079.  
  6080.      both sides to a sequence of 2-by-2 complex Hermitian matrices, defined by
  6081.      the elements of the vectors x, y and z. For i = 1,2,...,n
  6082.  
  6083.         (       x(i)  z(i) ) :=
  6084.  
  6085.      ZLARF applies a complex elementary reflector H to a complex M-by-N matrix
  6086.      C, from either the left or the right. H is represented in the form
  6087.  
  6088.      ZLARFB applies a complex block reflector H or its transpose H' to a
  6089.      complex M-by-N matrix C, from either the left or the right.
  6090.  
  6091.      ZLARFG generates a complex elementary reflector H of order n, such that
  6092.                 (   x   )   (   0  )
  6093.  
  6094.      ZLARFT forms the triangular factor T of a complex block reflector H of
  6095.      order n, which is defined as a product of k elementary reflectors.
  6096.  
  6097.      ZLARFX applies a complex elementary reflector H to a complex m by n
  6098.      matrix C, from either the left or the right. H is represented in the form
  6099.  
  6100.      ZLARGV generates a vector of complex plane rotations with real cosines,
  6101.      determined by elements of the complex vectors x and y.  For i = 1,2,...,n
  6102.  
  6103.      ZLARNV returns a vector of n random complex numbers from a uniform or
  6104.      normal distribution.
  6105.  
  6106.      ZLARTG generates a plane rotation so that
  6107.         [ -SN  CS  ]     [ G ]     [ 0 ]
  6108.  
  6109.      ZLARTV applies a vector of complex plane rotations with real cosines to
  6110.      elements of the complex vectors x and y. For i = 1,2,...,n
  6111.  
  6112.         ( x(i) ) := (        c(i)   s(i) ) ( x(i) )
  6113.  
  6114.      ZLASCL multiplies the M by N complex matrix A by the real scalar
  6115.      CTO/CFROM.  This is done without over/underflow as long as the final
  6116.      result CTO*A(I,J)/CFROM does not over/underflow. TYPE specifies that A
  6117.      may be full, upper triangular, lower triangular, upper Hessenberg, or
  6118.      banded.
  6119.  
  6120.      ZLASET initializes a 2-D array A to BETA on the diagonal and ALPHA on the
  6121.      offdiagonals.
  6122.  
  6123.      ZLASR   performs the transformation consisting of a sequence of plane
  6124.      rotations determined by the parameters PIVOT and DIRECT as follows ( z =
  6125.      m when SIDE = 'L' or 'l' and z = n when SIDE = 'R' or 'r' ):
  6126.  
  6127.      ZLASSQ returns the values scl and ssq such that
  6128.  
  6129.      where x( i ) = abs( X( 1 + ( i - 1 )*INCX ) ). The value of sumsq is
  6130.      assumed to be at least unity and the value of ssq will then satisfy
  6131.  
  6132.  
  6133.  
  6134.  
  6135.                                                                        PPPPaaaaggggeeee 99993333
  6136.  
  6137.  
  6138.  
  6139.  
  6140.  
  6141.  
  6142. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  6143.  
  6144.  
  6145.  
  6146.         1.0 .le. ssq .le. ( sumsq + 2*n ).
  6147.  
  6148.      ZLASWP performs a series of row interchanges on the matrix A.  One row
  6149.      interchange is initiated for each of rows K1 through K2 of A.
  6150.  
  6151.      ZLASYF computes a partial factorization of a complex symmetric matrix A
  6152.      using the Bunch-Kaufman diagonal pivoting method. The partial
  6153.      factorization has the form:
  6154.  
  6155.      ZLATBS solves one of the triangular systems
  6156.  
  6157.      with scaling to prevent overflow, where A is an upper or lower triangular
  6158.      band matrix.  Here A' denotes the transpose of A, x and b are n-element
  6159.      vectors, and s is a scaling factor, usually less than or equal to 1,
  6160.      chosen so that the components of x will be less than the overflow
  6161.      threshold.  If the unscaled problem will not cause overflow, the Level 2
  6162.      BLAS routine ZTBSV is called.  If the matrix A is singular (A(j,j) = 0
  6163.      for some j), then s is set to 0 and a non-trivial solution to A*x = 0 is
  6164.      returned.
  6165.  
  6166.      ZLATPS solves one of the triangular systems
  6167.  
  6168.      with scaling to prevent overflow, where A is an upper or lower triangular
  6169.      matrix stored in packed form.  Here A**T denotes the transpose of A, A**H
  6170.      denotes the conjugate transpose of A, x and b are n-element vectors, and
  6171.      s is a scaling factor, usually less than or equal to 1, chosen so that
  6172.      the components of x will be less than the overflow threshold.  If the
  6173.      unscaled problem will not cause overflow, the Level 2 BLAS routine ZTPSV
  6174.      is called. If the matrix A is singular (A(j,j) = 0 for some j), then s is
  6175.      set to 0 and a non-trivial solution to A*x = 0 is returned.
  6176.  
  6177.      ZLATRD reduces NB rows and columns of a complex Hermitian matrix A to
  6178.      Hermitian tridiagonal form by a unitary similarity transformation Q' * A
  6179.      * Q, and returns the matrices V and W which are needed to apply the
  6180.      transformation to the unreduced part of A.
  6181.  
  6182.      ZLATRS solves one of the triangular systems
  6183.  
  6184.      with scaling to prevent overflow.  Here A is an upper or lower triangular
  6185.      matrix, A**T denotes the transpose of A, A**H denotes the conjugate
  6186.      transpose of A, x and b are n-element vectors, and s is a scaling factor,
  6187.      usually less than or equal to 1, chosen so that the components of x will
  6188.      be less than the overflow threshold.  If the unscaled problem will not
  6189.      cause overflow, the Level 2 BLAS routine ZTRSV is called. If the matrix A
  6190.      is singular (A(j,j) = 0 for some j), then s is set to 0 and a non-trivial
  6191.      solution to A*x = 0 is returned.
  6192.  
  6193.      ZLATZM applies a Householder matrix generated by ZTZRQF to a matrix.
  6194.  
  6195.      ZLAUU2 computes the product U * U' or L' * L, where the triangular factor
  6196.      U or L is stored in the upper or lower triangular part of the array A.
  6197.  
  6198.  
  6199.  
  6200.  
  6201.                                                                        PPPPaaaaggggeeee 99994444
  6202.  
  6203.  
  6204.  
  6205.  
  6206.  
  6207.  
  6208. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  6209.  
  6210.  
  6211.  
  6212.      ZLAUUM computes the product U * U' or L' * L, where the triangular factor
  6213.      U or L is stored in the upper or lower triangular part of the array A.
  6214.  
  6215.      ZLAZRO initializes a 2-D array A to BETA on the diagonal and ALPHA on the
  6216.      offdiagonals.
  6217.  
  6218.      ZPBCON estimates the reciprocal of the condition number (in the 1-norm)
  6219.      of a complex Hermitian positive definite band matrix using the Cholesky
  6220.      factorization A = U**H*U or A = L*L**H computed by ZPBTRF.
  6221.  
  6222.      ZPBEQU computes row and column scalings intended to equilibrate a
  6223.      Hermitian positive definite band matrix A and reduce its condition number
  6224.      (with respect to the two-norm).  S contains the scale factors, S(i) =
  6225.      1/sqrt(A(i,i)), chosen so that the scaled matrix B with elements B(i,j) =
  6226.      S(i)*A(i,j)*S(j) has ones on the diagonal.  This choice of S puts the
  6227.      condition number of B within a factor N of the smallest possible
  6228.      condition number over all possible diagonal scalings.
  6229.  
  6230.      ZPBRFS improves the computed solution to a system of linear equations
  6231.      when the coefficient matrix is Hermitian positive definite and banded,
  6232.      and provides error bounds and backward error estimates for the solution.
  6233.  
  6234.      ZPBSV computes the solution to a complex system of linear equations
  6235.         A * X = B, where A is an N-by-N Hermitian positive definite band
  6236.      matrix and X and B are N-by-NRHS matrices.
  6237.  
  6238.      ZPBSVX uses the Cholesky factorization A = U**H*U or A = L*L**H to
  6239.      compute the solution to a complex system of linear equations
  6240.         A * X = B, where A is an N-by-N Hermitian positive definite band
  6241.      matrix and X and B are N-by-NRHS matrices.
  6242.  
  6243.      ZPBTF2 computes the Cholesky factorization of a complex Hermitian
  6244.      positive definite band matrix A.
  6245.  
  6246.      ZPBTRF computes the Cholesky factorization of a complex Hermitian
  6247.      positive definite band matrix A.
  6248.  
  6249.      ZPBTRS solves a system of linear equations A*X = B with a Hermitian
  6250.      positive definite band matrix A using the Cholesky factorization A =
  6251.      U**H*U or A = L*L**H computed by ZPBTRF.
  6252.  
  6253.      ZPOCON estimates the reciprocal of the condition number (in the 1-norm)
  6254.      of a complex Hermitian positive definite matrix using the Cholesky
  6255.      factorization A = U**H*U or A = L*L**H computed by ZPOTRF.
  6256.  
  6257.      ZPOEQU computes row and column scalings intended to equilibrate a
  6258.      Hermitian positive definite matrix A and reduce its condition number
  6259.      (with respect to the two-norm).  S contains the scale factors, S(i) =
  6260.      1/sqrt(A(i,i)), chosen so that the scaled matrix B with elements B(i,j) =
  6261.      S(i)*A(i,j)*S(j) has ones on the diagonal.  This choice of S puts the
  6262.      condition number of B within a factor N of the smallest possible
  6263.      condition number over all possible diagonal scalings.
  6264.  
  6265.  
  6266.  
  6267.                                                                        PPPPaaaaggggeeee 99995555
  6268.  
  6269.  
  6270.  
  6271.  
  6272.  
  6273.  
  6274. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  6275.  
  6276.  
  6277.  
  6278.      ZPORFS improves the computed solution to a system of linear equations
  6279.      when the coefficient matrix is Hermitian positive definite, and provides
  6280.      error bounds and backward error estimates for the solution.
  6281.  
  6282.      ZPOSV computes the solution to a complex system of linear equations
  6283.         A * X = B, where A is an N-by-N Hermitian positive definite matrix and
  6284.      X and B are N-by-NRHS matrices.
  6285.  
  6286.      ZPOSVX uses the Cholesky factorization A = U**H*U or A = L*L**H to
  6287.      compute the solution to a complex system of linear equations
  6288.         A * X = B, where A is an N-by-N Hermitian positive definite matrix and
  6289.      X and B are N-by-NRHS matrices.
  6290.  
  6291.      ZPOTF2 computes the Cholesky factorization of a complex Hermitian
  6292.      positive definite matrix A.
  6293.  
  6294.      ZPOTRF computes the Cholesky factorization of a complex Hermitian
  6295.      positive definite matrix A.
  6296.  
  6297.      ZPOTRI computes the inverse of a complex Hermitian positive definite
  6298.      matrix A using the Cholesky factorization A = U**H*U or A = L*L**H
  6299.      computed by ZPOTRF.
  6300.  
  6301.      ZPOTRS solves a system of linear equations A*X = B with a Hermitian
  6302.      positive definite matrix A using the Cholesky factorization A = U**H*U or
  6303.      A = L*L**H computed by ZPOTRF.
  6304.  
  6305.      ZPPCON estimates the reciprocal of the condition number (in the 1-norm)
  6306.      of a complex Hermitian positive definite packed matrix using the Cholesky
  6307.      factorization A = U**H*U or A = L*L**H computed by ZPPTRF.
  6308.  
  6309.      ZPPEQU computes row and column scalings intended to equilibrate a
  6310.      Hermitian positive definite matrix A in packed storage and reduce its
  6311.      condition number (with respect to the two-norm).  S contains the scale
  6312.      factors, S(i)=1/sqrt(A(i,i)), chosen so that the scaled matrix B with
  6313.      elements B(i,j)=S(i)*A(i,j)*S(j) has ones on the diagonal.  This choice
  6314.      of S puts the condition number of B within a factor N of the smallest
  6315.      possible condition number over all possible diagonal scalings.
  6316.  
  6317.      ZPPRFS improves the computed solution to a system of linear equations
  6318.      when the coefficient matrix is Hermitian positive definite and packed,
  6319.      and provides error bounds and backward error estimates for the solution.
  6320.  
  6321.      ZPPSV computes the solution to a complex system of linear equations
  6322.         A * X = B, where A is an N-by-N Hermitian positive definite matrix
  6323.      stored in packed format and X and B are N-by-NRHS matrices.
  6324.  
  6325.      ZPPSVX uses the Cholesky factorization A = U**H*U or A = L*L**H to
  6326.      compute the solution to a complex system of linear equations
  6327.         A * X = B, where A is an N-by-N Hermitian positive definite matrix
  6328.      stored in packed format and X and B are N-by-NRHS matrices.
  6329.  
  6330.  
  6331.  
  6332.  
  6333.                                                                        PPPPaaaaggggeeee 99996666
  6334.  
  6335.  
  6336.  
  6337.  
  6338.  
  6339.  
  6340. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  6341.  
  6342.  
  6343.  
  6344.      ZPPTRF computes the Cholesky factorization of a complex Hermitian
  6345.      positive definite matrix stored in packed format.
  6346.  
  6347.      ZPPTRI computes the inverse of a complex Hermitian positive definite
  6348.      matrix A using the Cholesky factorization A = U**H*U or A = L*L**H
  6349.      computed by ZPPTRF.
  6350.  
  6351.      ZPPTRS solves a system of linear equations A*X = B with a Hermitian
  6352.      positive definite matrix A in packed storage using the Cholesky
  6353.      factorization A = U**H*U or A = L*L**H computed by ZPPTRF.
  6354.  
  6355.      ZPTCON computes the reciprocal of the condition number (in the 1-norm) of
  6356.      a complex Hermitian positive definite tridiagonal matrix using the
  6357.      factorization A = L*D*L**T or A = U**T*D*U computed by ZPTTRF.
  6358.  
  6359.      ZPTEQR computes all eigenvalues and, optionally, eigenvectors of a
  6360.      symmetric positive definite tridiagonal matrix by first factoring the
  6361.      matrix using DPTTRF and then calling ZBDSQR to compute the singular
  6362.      values of the bidiagonal factor.
  6363.  
  6364.      ZPTRFS improves the computed solution to a system of linear equations
  6365.      when the coefficient matrix is Hermitian positive definite and
  6366.      tridiagonal, and provides error bounds and backward error estimates for
  6367.      the solution.
  6368.  
  6369.      ZPTSV computes the solution to a complex system of linear equations A*X =
  6370.      B, where A is an N-by-N Hermitian positive definite tridiagonal matrix,
  6371.      and X and B are N-by-NRHS matrices.
  6372.  
  6373.      ZPTSVX uses the factorization A = L*D*L**H to compute the solution to a
  6374.      complex system of linear equations A*X = B, where A is an N-by-N
  6375.      Hermitian positive definite tridiagonal matrix and X and B are N-by-NRHS
  6376.      matrices.
  6377.  
  6378.      ZPTTRF computes the factorization of a complex Hermitian positive
  6379.      definite tridiagonal matrix A.
  6380.  
  6381.      ZPTTRS solves a system of linear equations A * X = B with a Hermitian
  6382.      positive definite tridiagonal matrix A using the factorization A =
  6383.      U**H*D*U or A = L*D*L**H computed by ZPTTRF.
  6384.  
  6385.      ZROT   applies a plane rotation, where the cos (C) is real and the sin
  6386.      (S) is complex, and the vectors CX and CY are complex.
  6387.  
  6388.      ZSPCON estimates the reciprocal of the condition number (in the 1-norm)
  6389.      of a complex symmetric packed matrix A using the factorization A =
  6390.      U*D*U**T or A = L*D*L**T computed by ZSPTRF.
  6391.  
  6392.      ZSPMV  performs the matrix-vector operation
  6393.  
  6394.      where alpha and beta are scalars, x and y are n element vectors and A is
  6395.      an n by n symmetric matrix, supplied in packed form.
  6396.  
  6397.  
  6398.  
  6399.                                                                        PPPPaaaaggggeeee 99997777
  6400.  
  6401.  
  6402.  
  6403.  
  6404.  
  6405.  
  6406. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  6407.  
  6408.  
  6409.  
  6410.      ZSPR    performs the symmetric rank 1 operation
  6411.  
  6412.      where alpha is a complex scalar, x is an n element vector and A is an n
  6413.      by n symmetric matrix, supplied in packed form.
  6414.  
  6415.      ZSPRFS improves the computed solution to a system of linear equations
  6416.      when the coefficient matrix is symmetric indefinite and packed, and
  6417.      provides error bounds and backward error estimates for the solution.
  6418.  
  6419.      ZSPSV computes the solution to a complex system of linear equations
  6420.         A * X = B, where A is an N-by-N symmetric matrix stored in packed
  6421.      format and X and B are N-by-NRHS matrices.
  6422.  
  6423.      ZSPSVX uses the diagonal pivoting factorization A = U*D*U**T or A =
  6424.      L*D*L**T to compute the solution to a complex system of linear equations
  6425.      A * X = B, where A is an N-by-N symmetric matrix stored in packed format
  6426.      and X and B are N-by-NRHS matrices.
  6427.  
  6428.      ZSPTRF computes the factorization of a complex symmetric matrix A stored
  6429.      in packed format using the Bunch-Kaufman diagonal pivoting method:
  6430.  
  6431.         A = U*D*U**T  or  A = L*D*L**T
  6432.  
  6433.      ZSPTRI computes the inverse of a complex symmetric indefinite matrix A in
  6434.      packed storage using the factorization A = U*D*U**T or A = L*D*L**T
  6435.      computed by ZSPTRF.
  6436.  
  6437.      ZSPTRS solves a system of linear equations A*X = B with a complex
  6438.      symmetric matrix A stored in packed format using the factorization A =
  6439.      U*D*U**T or A = L*D*L**T computed by ZSPTRF.
  6440.  
  6441.      ZSTEIN computes the eigenvectors of a real symmetric tridiagonal matrix T
  6442.      corresponding to specified eigenvalues, using inverse iteration.
  6443.  
  6444.      ZSTEQR computes all eigenvalues and, optionally, eigenvectors of a
  6445.      symmetric tridiagonal matrix using the implicit QL or QR method.  The
  6446.      eigenvectors of a full or band complex Hermitian matrix can also be found
  6447.      if ZSYTRD or ZSPTRD or ZSBTRD has been used to reduce this matrix to
  6448.      tridiagonal form.
  6449.  
  6450.      ZSYCON estimates the reciprocal of the condition number (in the 1-norm)
  6451.      of a complex symmetric matrix A using the factorization A = U*D*U**T or A
  6452.      = L*D*L**T computed by ZSYTRF.
  6453.  
  6454.      ZSYMV  performs the matrix-vector  operation
  6455.  
  6456.      where alpha and beta are scalars, x and y are n element vectors and A is
  6457.      an n by n symmetric matrix.
  6458.  
  6459.      ZSYR   performs the symmetric rank 1 operation
  6460.  
  6461.      where alpha is a complex scalar, x is an n element vector and A is an n
  6462.  
  6463.  
  6464.  
  6465.                                                                        PPPPaaaaggggeeee 99998888
  6466.  
  6467.  
  6468.  
  6469.  
  6470.  
  6471.  
  6472. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  6473.  
  6474.  
  6475.  
  6476.      by n symmetric matrix.
  6477.  
  6478.      ZSYRFS improves the computed solution to a system of linear equations
  6479.      when the coefficient matrix is symmetric indefinite, and provides error
  6480.      bounds and backward error estimates for the solution.
  6481.  
  6482.      ZSYSV computes the solution to a complex system of linear equations
  6483.         A * X = B, where A is an N-by-N symmetric matrix and X and B are N-
  6484.      by-NRHS matrices.
  6485.  
  6486.      ZSYSVX uses the diagonal pivoting factorization to compute the solution
  6487.      to a complex system of linear equations A * X = B, where A is an N-by-N
  6488.      symmetric matrix and X and B are N-by-NRHS matrices.
  6489.  
  6490.      ZSYTF2 computes the factorization of a complex symmetric matrix A using
  6491.      the Bunch-Kaufman diagonal pivoting method:
  6492.  
  6493.         A = U*D*U'  or  A = L*D*L'
  6494.  
  6495.      ZSYTRF computes the factorization of a complex symmetric matrix A using
  6496.      the Bunch-Kaufman diagonal pivoting method.  The form of the
  6497.      factorization is
  6498.  
  6499.      ZSYTRI computes the inverse of a complex symmetric indefinite matrix A
  6500.      using the factorization A = U*D*U**T or A = L*D*L**T computed by ZSYTRF.
  6501.  
  6502.      ZSYTRS solves a system of linear equations A*X = B with a complex
  6503.      symmetric matrix A using the factorization A = U*D*U**T or A = L*D*L**T
  6504.      computed by ZSYTRF.
  6505.  
  6506.      ZTBCON estimates the reciprocal of the condition number of a triangular
  6507.      band matrix A, in either the 1-norm or the infinity-norm.
  6508.  
  6509.      ZTBRFS provides error bounds and backward error estimates for the
  6510.      solution to a system of linear equations with a triangular band
  6511.      coefficient matrix.
  6512.  
  6513.      ZTBTRS solves a triangular system of the form
  6514.  
  6515.      where A is a triangular band matrix of order N, and B is an N-by-NRHS
  6516.      matrix.  A check is made to verify that A is nonsingular.
  6517.  
  6518.      ZTGEVC computes selected left and/or right generalized eigenvectors of a
  6519.      pair of complex upper triangular matrices (A,B).  The j-th generalized
  6520.      left and right eigenvectors are  y  and  x, resp., such that:
  6521.  
  6522.      ZTGSJA computes the generalized singular value decomposition (GSVD) of
  6523.      two complex upper triangular (or trapezoidal) matrices A and B.
  6524.  
  6525.      ZTPCON estimates the reciprocal of the condition number of a packed
  6526.      triangular matrix A, in either the 1-norm or the infinity-norm.
  6527.  
  6528.  
  6529.  
  6530.  
  6531.                                                                        PPPPaaaaggggeeee 99999999
  6532.  
  6533.  
  6534.  
  6535.  
  6536.  
  6537.  
  6538. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  6539.  
  6540.  
  6541.  
  6542.      ZTPRFS provides error bounds and backward error estimates for the
  6543.      solution to a system of linear equations with a triangular packed
  6544.      coefficient matrix.
  6545.  
  6546.      ZTPTRI computes the inverse of a complex upper or lower triangular matrix
  6547.      A stored in packed format.
  6548.  
  6549.      ZTPTRS solves a triangular system of the form
  6550.  
  6551.      where A is a triangular matrix of order N stored in packed format, and B
  6552.      is an N-by-NRHS matrix.  A check is made to verify that A is nonsingular.
  6553.  
  6554.      ZTRCON estimates the reciprocal of the condition number of a triangular
  6555.      matrix A, in either the 1-norm or the infinity-norm.
  6556.  
  6557.      ZTREVC computes all or some right and/or left eigenvectors of a complex
  6558.      upper triangular matrix T.
  6559.  
  6560.      ZTREXC reorders the Schur factorization of a complex matrix A = Q*T*Q**H,
  6561.      so that the diagonal element of T with row index IFST is moved to row
  6562.      ILST.
  6563.  
  6564.      ZTRRFS provides error bounds and backward error estimates for the
  6565.      solution to a system of linear equations with a triangular coefficient
  6566.      matrix.
  6567.  
  6568.      ZTRSEN reorders the Schur factorization of a complex matrix A = Q*T*Q**H,
  6569.      so that a selected cluster of eigenvalues appears in the leading
  6570.      positions on the diagonal of the upper triangular matrix T, and the
  6571.      leading columns of Q form an orthonormal basis of the corresponding right
  6572.      invariant subspace.
  6573.  
  6574.      ZTRSNA estimates reciprocal condition numbers for specified eigenvalues
  6575.      and/or right eigenvectors of a complex upper triangular matrix T (or of
  6576.      any matrix Q*T*Q**H with Q unitary).
  6577.  
  6578.      ZTRSYL solves the complex Sylvester matrix equation:
  6579.  
  6580.         op(A)*X + X*op(B) = scale*C or
  6581.  
  6582.      ZTRTI2 computes the inverse of a complex upper or lower triangular
  6583.      matrix.
  6584.  
  6585.      ZTRTRI computes the inverse of a complex upper or lower triangular matrix
  6586.      A.
  6587.  
  6588.      ZTRTRS solves a triangular system of the form
  6589.  
  6590.      where A is a triangular matrix of order N, and B is an N-by-NRHS matrix.
  6591.      A check is made to verify that A is nonsingular.
  6592.  
  6593.      ZTZRQF reduces the M-by-N ( M<=N ) complex upper trapezoidal matrix A to
  6594.  
  6595.  
  6596.  
  6597.                                                                       PPPPaaaaggggeeee 111100000000
  6598.  
  6599.  
  6600.  
  6601.  
  6602.  
  6603.  
  6604. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  6605.  
  6606.  
  6607.  
  6608.      upper triangular form by means of unitary transformations.
  6609.  
  6610.      ZUNG2L generates an m by n complex matrix Q with orthonormal columns,
  6611.      which is defined as the last n columns of a product of k elementary
  6612.      reflectors of order m
  6613.  
  6614.      ZUNG2R generates an m by n complex matrix Q with orthonormal columns,
  6615.      which is defined as the first n columns of a product of k elementary
  6616.      reflectors of order m
  6617.  
  6618.      ZUNGBR generates one of the matrices Q or P**H determined by ZGEBRD when
  6619.      reducing a complex matrix A to bidiagonal form:  A = Q * B * P**H.
  6620.  
  6621.      ZUNGHR generates a complex unitary matrix Q which is defined as the
  6622.      product of IHI-ILO elementary reflectors of order N, as returned by
  6623.      ZGEHRD:
  6624.  
  6625.      Q = H(ilo) H(ilo+1) . . . H(ihi-1).
  6626.  
  6627.      ZUNGL2 generates an m-by-n complex matrix Q with orthonormal rows, which
  6628.      is defined as the first m rows of a product of k elementary reflectors of
  6629.      order n
  6630.  
  6631.      ZUNGLQ generates an M-by-N complex matrix Q with orthonormal rows, which
  6632.      is defined as the first M rows of a product of K elementary reflectors of
  6633.      order N
  6634.  
  6635.      ZUNGQL generates an M-by-N complex matrix Q with orthonormal columns,
  6636.      which is defined as the last N columns of a product of K elementary
  6637.      reflectors of order M
  6638.  
  6639.      ZUNGQR generates an M-by-N complex matrix Q with orthonormal columns,
  6640.      which is defined as the first N columns of a product of K elementary
  6641.      reflectors of order M
  6642.  
  6643.      ZUNGR2 generates an m by n complex matrix Q with orthonormal rows, which
  6644.      is defined as the last m rows of a product of k elementary reflectors of
  6645.      order n
  6646.  
  6647.      ZUNGRQ generates an M-by-N complex matrix Q with orthonormal rows, which
  6648.      is defined as the last M rows of a product of K elementary reflectors of
  6649.      order N
  6650.  
  6651.      ZUNGTR generates a complex unitary matrix Q which is defined as the
  6652.      product of n-1 elementary reflectors of order N, as returned by ZHETRD:
  6653.  
  6654.      if UPLO = 'U', Q = H(n-1) . . . H(2) H(1),
  6655.  
  6656.      ZUNM2L overwrites the general complex m-by-n matrix C with
  6657.  
  6658.      where Q is a complex unitary matrix defined as the product of k
  6659.      elementary reflectors
  6660.  
  6661.  
  6662.  
  6663.                                                                       PPPPaaaaggggeeee 111100001111
  6664.  
  6665.  
  6666.  
  6667.  
  6668.  
  6669.  
  6670. CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))                                        CCCCOOOOMMMMPPPPLLLLIIIIBBBB....SSSSGGGGIIIIMMMMAAAATTTTHHHH((((3333FFFF))))
  6671.  
  6672.  
  6673.  
  6674.      ZUNM2R overwrites the general complex m-by-n matrix C with
  6675.  
  6676.      where Q is a complex unitary matrix defined as the product of k
  6677.      elementary reflectors
  6678.  
  6679.      If VECT = 'Q', ZUNMBR overwrites the general complex M-by-N matrix C with
  6680.                      SIDE = 'L'     SIDE = 'R' TRANS = 'N':      Q * C
  6681.      C * Q TRANS = 'C':      Q**H * C       C * Q**H
  6682.  
  6683.      ZUNMHR overwrites the general complex M-by-N matrix C with TRANS = 'C':
  6684.      Q**H * C       C * Q**H
  6685.  
  6686.      ZUNML2 overwrites the general complex m-by-n matrix C with
  6687.  
  6688.      where Q is a complex unitary matrix defined as the product of k
  6689.      elementary reflectors
  6690.  
  6691.      ZUNMLQ overwrites the general complex M-by-N matrix C with TRANS = 'C':
  6692.      Q**H * C       C * Q**H
  6693.  
  6694.      ZUNMQL overwrites the general complex M-by-N matrix C with TRANS = 'C':
  6695.      Q**H * C       C * Q**H
  6696.  
  6697.      ZUNMQR overwrites the general complex M-by-N matrix C with TRANS = 'C':
  6698.      Q**H * C       C * Q**H
  6699.  
  6700.      ZUNMR2 overwrites the general complex m-by-n matrix C with
  6701.  
  6702.      where Q is a complex unitary matrix defined as the product of k
  6703.      elementary reflectors
  6704.  
  6705.      ZUNMRQ overwrites the general complex M-by-N matrix C with TRANS = 'C':
  6706.      Q**H * C       C * Q**H
  6707.  
  6708.      ZUNMTR overwrites the general complex M-by-N matrix C with TRANS = 'C':
  6709.      Q**H * C       C * Q**H
  6710.  
  6711.      ZUPGTR generates a complex unitary matrix Q which is defined as the
  6712.      product of n-1 elementary reflectors of order n, as returned by ZHPTRD
  6713.      using packed storage:
  6714.  
  6715.      if UPLO = 'U', Q = H(n-1) . . . H(2) H(1),
  6716.  
  6717.      ZUPMTR overwrites the general complex M-by-N matrix C with TRANS = 'C':
  6718.      Q**H * C       C * Q**H
  6719.  
  6720.  
  6721.  
  6722.  
  6723.  
  6724.  
  6725.  
  6726.  
  6727.  
  6728.  
  6729.                                                                       PPPPaaaaggggeeee 111100002222
  6730.  
  6731.  
  6732.  
  6733.